@code-pushup/cli 0.49.0 → 0.51.0

package/index.js

@@ -163,9 +163,27 @@ function hasNonZeroWeightedRef(refs) {
   return refs.reduce((acc, { weight }) => weight + acc, 0) !== 0;
 }
 
-// packages/models/src/lib/audit.ts
+// packages/models/src/lib/source.ts
 import { z as z2 } from "zod";
-var auditSchema = z2.object({
+var sourceFileLocationSchema = z2.object(
+  {
+    file: filePathSchema.describe("Relative path to source file in Git repo"),
+    position: z2.object(
+      {
+        startLine: positiveIntSchema.describe("Start line"),
+        startColumn: positiveIntSchema.describe("Start column").optional(),
+        endLine: positiveIntSchema.describe("End line").optional(),
+        endColumn: positiveIntSchema.describe("End column").optional()
+      },
+      { description: "Location in file" }
+    ).optional()
+  },
+  { description: "Source file location" }
+);
+
+// packages/models/src/lib/audit.ts
+import { z as z3 } from "zod";
+var auditSchema = z3.object({
   slug: slugSchema.describe("ID (unique within plugin)")
 }).merge(
   metaSchema({
@@ -175,7 +193,7 @@ var auditSchema = z2.object({
     description: "List of scorable metrics for the given plugin"
   })
 );
-var pluginAuditsSchema = z2.array(auditSchema, {
+var pluginAuditsSchema = z3.array(auditSchema, {
   description: "List of audits maintained in a plugin"
 }).min(1).refine(
   (auditMetadata) => !getDuplicateSlugsInAudits(auditMetadata),
@@ -194,31 +212,16 @@ function getDuplicateSlugsInAudits(audits) {
 }
 
 // packages/models/src/lib/audit-output.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // packages/models/src/lib/issue.ts
-import { z as z3 } from "zod";
-var sourceFileLocationSchema = z3.object(
-  {
-    file: filePathSchema.describe("Relative path to source file in Git repo"),
-    position: z3.object(
-      {
-        startLine: positiveIntSchema.describe("Start line"),
-        startColumn: positiveIntSchema.describe("Start column").optional(),
-        endLine: positiveIntSchema.describe("End line").optional(),
-        endColumn: positiveIntSchema.describe("End column").optional()
-      },
-      { description: "Location in file" }
-    ).optional()
-  },
-  { description: "Source file location" }
-);
-var issueSeveritySchema = z3.enum(["info", "warning", "error"], {
+import { z as z4 } from "zod";
+var issueSeveritySchema = z4.enum(["info", "warning", "error"], {
   description: "Severity level"
 });
-var issueSchema = z3.object(
+var issueSchema = z4.object(
   {
-    message: z3.string({ description: "Descriptive error message" }).max(MAX_ISSUE_MESSAGE_LENGTH),
+    message: z4.string({ description: "Descriptive error message" }).max(MAX_ISSUE_MESSAGE_LENGTH),
     severity: issueSeveritySchema,
     source: sourceFileLocationSchema.optional()
   },
@@ -226,60 +229,60 @@ var issueSchema = z3.object(
 );
 
 // packages/models/src/lib/table.ts
-import { z as z4 } from "zod";
-var tableAlignmentSchema = z4.enum(["left", "center", "right"], {
+import { z as z5 } from "zod";
+var tableAlignmentSchema = z5.enum(["left", "center", "right"], {
   description: "Cell alignment"
 });
-var tableColumnObjectSchema = z4.object({
-  key: z4.string(),
-  label: z4.string().optional(),
+var tableColumnObjectSchema = z5.object({
+  key: z5.string(),
+  label: z5.string().optional(),
   align: tableAlignmentSchema.optional()
 });
-var tableRowObjectSchema = z4.record(tableCellValueSchema, {
+var tableRowObjectSchema = z5.record(tableCellValueSchema, {
   description: "Object row"
 });
-var tableRowPrimitiveSchema = z4.array(tableCellValueSchema, {
+var tableRowPrimitiveSchema = z5.array(tableCellValueSchema, {
   description: "Primitive row"
 });
-var tableSharedSchema = z4.object({
-  title: z4.string().optional().describe("Display title for table")
+var tableSharedSchema = z5.object({
+  title: z5.string().optional().describe("Display title for table")
 });
 var tablePrimitiveSchema = tableSharedSchema.merge(
-  z4.object(
+  z5.object(
     {
-      columns: z4.array(tableAlignmentSchema).optional(),
-      rows: z4.array(tableRowPrimitiveSchema)
+      columns: z5.array(tableAlignmentSchema).optional(),
+      rows: z5.array(tableRowPrimitiveSchema)
     },
     { description: "Table with primitive rows and optional alignment columns" }
   )
 );
 var tableObjectSchema = tableSharedSchema.merge(
-  z4.object(
+  z5.object(
     {
-      columns: z4.union([
-        z4.array(tableAlignmentSchema),
-        z4.array(tableColumnObjectSchema)
+      columns: z5.union([
+        z5.array(tableAlignmentSchema),
+        z5.array(tableColumnObjectSchema)
       ]).optional(),
-      rows: z4.array(tableRowObjectSchema)
+      rows: z5.array(tableRowObjectSchema)
     },
     {
       description: "Table with object rows and optional alignment or object columns"
     }
   )
 );
-var tableSchema = (description = "Table information") => z4.union([tablePrimitiveSchema, tableObjectSchema], { description });
+var tableSchema = (description = "Table information") => z5.union([tablePrimitiveSchema, tableObjectSchema], { description });
 
 // packages/models/src/lib/audit-output.ts
 var auditValueSchema = nonnegativeNumberSchema.describe("Raw numeric value");
-var auditDisplayValueSchema = z5.string({ description: "Formatted value (e.g. '0.9 s', '2.1 MB')" }).optional();
-var auditDetailsSchema = z5.object(
+var auditDisplayValueSchema = z6.string({ description: "Formatted value (e.g. '0.9 s', '2.1 MB')" }).optional();
+var auditDetailsSchema = z6.object(
   {
-    issues: z5.array(issueSchema, { description: "List of findings" }).optional(),
+    issues: z6.array(issueSchema, { description: "List of findings" }).optional(),
     table: tableSchema("Table of related findings").optional()
   },
   { description: "Detailed information" }
 );
-var auditOutputSchema = z5.object(
+var auditOutputSchema = z6.object(
   {
     slug: slugSchema.describe("Reference to audit"),
     displayValue: auditDisplayValueSchema,
@@ -289,7 +292,7 @@ var auditOutputSchema = z5.object(
   },
   { description: "Audit information" }
 );
-var auditOutputsSchema = z5.array(auditOutputSchema, {
+var auditOutputsSchema = z6.array(auditOutputSchema, {
   description: "List of JSON formatted audit output emitted by the runner process of a plugin"
 }).refine(
   (audits) => !getDuplicateSlugsInAudits2(audits),
@@ -306,13 +309,13 @@ function getDuplicateSlugsInAudits2(audits) {
 }
 
 // packages/models/src/lib/category-config.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 var categoryRefSchema = weightedRefSchema(
   "Weighted references to audits and/or groups for the category",
   "Slug of an audit or group (depending on `type`)"
 ).merge(
-  z6.object({
-    type: z6.enum(["audit", "group"], {
+  z7.object({
+    type: z7.enum(["audit", "group"], {
       description: "Discriminant for reference kind, affects where `slug` is looked up"
     }),
     plugin: slugSchema.describe(
@@ -333,8 +336,8 @@ var categoryConfigSchema = scorableSchema(
     description: "Meta info for category"
   })
 ).merge(
-  z6.object({
-    isBinary: z6.boolean({
+  z7.object({
+    isBinary: z7.boolean({
       description: 'Is this a binary category (i.e. only a perfect score considered a "pass")?'
     }).optional()
   })
@@ -350,7 +353,7 @@ function getDuplicateRefsInCategoryMetrics(metrics) {
     metrics.map(({ slug, type, plugin }) => `${type} :: ${plugin} / ${slug}`)
   );
 }
-var categoriesSchema = z6.array(categoryConfigSchema, {
+var categoriesSchema = z7.array(categoryConfigSchema, {
   description: "Categorization of individual audits"
 }).refine(
   (categoryCfg) => !getDuplicateSlugCategories(categoryCfg),
@@ -369,18 +372,18 @@ function getDuplicateSlugCategories(categories) {
 }
 
 // packages/models/src/lib/commit.ts
-import { z as z7 } from "zod";
-var commitSchema = z7.object(
+import { z as z8 } from "zod";
+var commitSchema = z8.object(
   {
-    hash: z7.string({ description: "Commit SHA (full)" }).regex(
+    hash: z8.string({ description: "Commit SHA (full)" }).regex(
       /^[\da-f]{40}$/,
       "Commit SHA should be a 40-character hexadecimal string"
     ),
-    message: z7.string({ description: "Commit message" }),
-    date: z7.coerce.date({
+    message: z8.string({ description: "Commit message" }),
+    date: z8.coerce.date({
       description: "Date and time when commit was authored"
     }),
-    author: z7.string({
+    author: z8.string({
       description: "Commit author name"
     }).trim()
   },
@@ -388,22 +391,22 @@ var commitSchema = z7.object(
 );
 
 // packages/models/src/lib/core-config.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 
 // packages/models/src/lib/persist-config.ts
-import { z as z8 } from "zod";
-var formatSchema = z8.enum(["json", "md"]);
-var persistConfigSchema = z8.object({
+import { z as z9 } from "zod";
+var formatSchema = z9.enum(["json", "md"]);
+var persistConfigSchema = z9.object({
   outputDir: filePathSchema.describe("Artifacts folder").optional(),
   filename: fileNameSchema.describe("Artifacts file name (without extension)").optional(),
-  format: z8.array(formatSchema).optional()
+  format: z9.array(formatSchema).optional()
 });
 
 // packages/models/src/lib/plugin-config.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 
 // packages/models/src/lib/group.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 var groupRefSchema = weightedRefSchema(
   "Weighted reference to a group",
   "Reference slug to a group within this plugin (e.g. 'max-lines')"
@@ -420,7 +423,7 @@ var groupSchema = scorableSchema(
   getDuplicateRefsInGroups,
   duplicateRefsInGroupsErrorMsg
 ).merge(groupMetaSchema);
-var groupsSchema = z9.array(groupSchema, {
+var groupsSchema = z10.array(groupSchema, {
   description: "List of groups"
 }).optional().refine(
   (groups2) => !getDuplicateSlugsInGroups(groups2),
@@ -448,14 +451,14 @@ function getDuplicateSlugsInGroups(groups2) {
 }
 
 // packages/models/src/lib/runner-config.ts
-import { z as z10 } from "zod";
-var outputTransformSchema = z10.function().args(z10.unknown()).returns(z10.union([auditOutputsSchema, z10.promise(auditOutputsSchema)]));
-var runnerConfigSchema = z10.object(
+import { z as z11 } from "zod";
+var outputTransformSchema = z11.function().args(z11.unknown()).returns(z11.union([auditOutputsSchema, z11.promise(auditOutputsSchema)]));
+var runnerConfigSchema = z11.object(
   {
-    command: z10.string({
+    command: z11.string({
       description: "Shell command to execute"
     }),
-    args: z10.array(z10.string({ description: "Command arguments" })).optional(),
+    args: z11.array(z11.string({ description: "Command arguments" })).optional(),
     outputFile: filePathSchema.describe("Output path"),
     outputTransform: outputTransformSchema.optional()
   },
@@ -463,8 +466,8 @@ var runnerConfigSchema = z10.object(
     description: "How to execute runner"
   }
 );
-var onProgressSchema = z10.function().args(z10.unknown()).returns(z10.void());
-var runnerFunctionSchema = z10.function().args(onProgressSchema.optional()).returns(z10.union([auditOutputsSchema, z10.promise(auditOutputsSchema)]));
+var onProgressSchema = z11.function().args(z11.unknown()).returns(z11.void());
+var runnerFunctionSchema = z11.function().args(onProgressSchema.optional()).returns(z11.union([auditOutputsSchema, z11.promise(auditOutputsSchema)]));
 
 // packages/models/src/lib/plugin-config.ts
 var pluginMetaSchema = packageVersionSchema().merge(
@@ -475,13 +478,13 @@ var pluginMetaSchema = packageVersionSchema().merge(
     description: "Plugin metadata"
   })
 ).merge(
-  z11.object({
+  z12.object({
     slug: slugSchema.describe("Unique plugin slug within core config"),
     icon: materialIconSchema
   })
 );
-var pluginDataSchema = z11.object({
-  runner: z11.union([runnerConfigSchema, runnerFunctionSchema]),
+var pluginDataSchema = z12.object({
+  runner: z12.union([runnerConfigSchema, runnerFunctionSchema]),
   audits: pluginAuditsSchema,
   groups: groupsSchema
 });
@@ -507,22 +510,22 @@ function getMissingRefsFromGroups(pluginCfg) {
 }
 
 // packages/models/src/lib/upload-config.ts
-import { z as z12 } from "zod";
-var uploadConfigSchema = z12.object({
+import { z as z13 } from "zod";
+var uploadConfigSchema = z13.object({
   server: urlSchema.describe("URL of deployed portal API"),
-  apiKey: z12.string({
+  apiKey: z13.string({
     description: "API key with write access to portal (use `process.env` for security)"
   }),
   organization: slugSchema.describe(
     "Organization slug from Code PushUp portal"
   ),
   project: slugSchema.describe("Project slug from Code PushUp portal"),
-  timeout: z12.number({ description: "Request timeout in minutes (default is 5)" }).positive().int().optional()
+  timeout: z13.number({ description: "Request timeout in minutes (default is 5)" }).positive().int().optional()
 });
 
 // packages/models/src/lib/core-config.ts
-var unrefinedCoreConfigSchema = z13.object({
-  plugins: z13.array(pluginConfigSchema, {
+var unrefinedCoreConfigSchema = z14.object({
+  plugins: z14.array(pluginConfigSchema, {
     description: "List of plugins to be used (official, community-provided, or custom)"
   }).min(1),
   /** portal configuration for persisting results */
@@ -554,7 +557,7 @@ var DEFAULT_PERSIST_FILENAME = "report";
 var DEFAULT_PERSIST_FORMAT = ["json", "md"];
 
 // packages/models/src/lib/report.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 var auditReportSchema = auditSchema.merge(auditOutputSchema);
 var pluginReportSchema = pluginMetaSchema.merge(
   executionMetaSchema({
@@ -562,9 +565,9 @@ var pluginReportSchema = pluginMetaSchema.merge(
     descriptionDuration: "Duration of the plugin run in ms"
   })
 ).merge(
-  z14.object({
-    audits: z14.array(auditReportSchema).min(1),
-    groups: z14.array(groupSchema).optional()
+  z15.object({
+    audits: z15.array(auditReportSchema).min(1),
+    groups: z15.array(groupSchema).optional()
   })
 ).refine(
   (pluginReport) => !getMissingRefsFromGroups2(pluginReport.audits, pluginReport.groups ?? []),
@@ -598,10 +601,10 @@ var reportSchema = packageVersionSchema({
     descriptionDuration: "Duration of the collect run in ms"
   })
 ).merge(
-  z14.object(
+  z15.object(
     {
-      categories: z14.array(categoryConfigSchema),
-      plugins: z14.array(pluginReportSchema).min(1),
+      categories: z15.array(categoryConfigSchema),
+      plugins: z15.array(pluginReportSchema).min(1),
       commit: commitSchema.describe("Git commit for which report was collected").nullable()
     },
     { description: "Collect output data" }
@@ -617,40 +620,40 @@ var reportSchema = packageVersionSchema({
 );
 
 // packages/models/src/lib/reports-diff.ts
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
 function makeComparisonSchema(schema) {
   const sharedDescription = schema.description || "Result";
-  return z15.object({
+  return z16.object({
     before: schema.describe(`${sharedDescription} (source commit)`),
     after: schema.describe(`${sharedDescription} (target commit)`)
   });
 }
 function makeArraysComparisonSchema(diffSchema, resultSchema, description) {
-  return z15.object(
+  return z16.object(
     {
-      changed: z15.array(diffSchema),
-      unchanged: z15.array(resultSchema),
-      added: z15.array(resultSchema),
-      removed: z15.array(resultSchema)
+      changed: z16.array(diffSchema),
+      unchanged: z16.array(resultSchema),
+      added: z16.array(resultSchema),
+      removed: z16.array(resultSchema)
     },
     { description }
   );
 }
-var scorableMetaSchema = z15.object({
+var scorableMetaSchema = z16.object({
   slug: slugSchema,
   title: titleSchema,
   docsUrl: docsUrlSchema
 });
 var scorableWithPluginMetaSchema = scorableMetaSchema.merge(
-  z15.object({
+  z16.object({
     plugin: pluginMetaSchema.pick({ slug: true, title: true, docsUrl: true }).describe("Plugin which defines it")
   })
 );
 var scorableDiffSchema = scorableMetaSchema.merge(
-  z15.object({
+  z16.object({
     scores: makeComparisonSchema(scoreSchema).merge(
-      z15.object({
-        diff: z15.number().min(-1).max(1).describe("Score change (`scores.after - scores.before`)")
+      z16.object({
+        diff: z16.number().min(-1).max(1).describe("Score change (`scores.after - scores.before`)")
       })
     ).describe("Score comparison")
   })
@@ -661,10 +664,10 @@ var scorableWithPluginDiffSchema = scorableDiffSchema.merge(
 var categoryDiffSchema = scorableDiffSchema;
 var groupDiffSchema = scorableWithPluginDiffSchema;
 var auditDiffSchema = scorableWithPluginDiffSchema.merge(
-  z15.object({
+  z16.object({
     values: makeComparisonSchema(auditValueSchema).merge(
-      z15.object({
-        diff: z15.number().int().describe("Value change (`values.after - values.before`)")
+      z16.object({
+        diff: z16.number().int().describe("Value change (`values.after - values.before`)")
       })
     ).describe("Audit `value` comparison"),
     displayValues: makeComparisonSchema(auditDisplayValueSchema).describe(
@@ -673,16 +676,18 @@ var auditDiffSchema = scorableWithPluginDiffSchema.merge(
   })
 );
 var categoryResultSchema = scorableMetaSchema.merge(
-  z15.object({ score: scoreSchema })
+  z16.object({ score: scoreSchema })
 );
 var groupResultSchema = scorableWithPluginMetaSchema.merge(
-  z15.object({ score: scoreSchema })
+  z16.object({ score: scoreSchema })
 );
 var auditResultSchema = scorableWithPluginMetaSchema.merge(
   auditOutputSchema.pick({ score: true, value: true, displayValue: true })
 );
-var reportsDiffSchema = z15.object({
+var reportsDiffSchema = z16.object({
   commits: makeComparisonSchema(commitSchema).nullable().describe("Commits identifying compared reports"),
+  portalUrl: urlSchema.optional().describe("Link to comparison page in Code PushUp portal"),
+  label: z16.string().optional().describe("Label (e.g. project name)"),
   categories: makeArraysComparisonSchema(
     categoryDiffSchema,
     categoryResultSchema,
@@ -752,8 +757,24 @@ function comparePairs(pairs, equalsFn) {
   );
 }
 
+// packages/utils/src/lib/errors.ts
+function stringifyError(error) {
+  if (error instanceof Error) {
+    if (error.name === "Error" || error.message.startsWith(error.name)) {
+      return error.message;
+    }
+    return `${error.name}: ${error.message}`;
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  return JSON.stringify(error);
+}
+
 // packages/utils/src/lib/execute-process.ts
-import { spawn } from "node:child_process";
+import {
+  spawn
+} from "node:child_process";
 
 // packages/utils/src/lib/reports/utils.ts
 import ansis from "ansis";
@@ -839,9 +860,17 @@ function severityMarker(severity) {
   }
   return "\u2139\uFE0F";
 }
+var MIN_NON_ZERO_RESULT = 0.1;
+function roundValue(value) {
+  const roundedValue = Math.round(value * 10) / 10;
+  if (roundedValue === 0 && value !== 0) {
+    return MIN_NON_ZERO_RESULT * Math.sign(value);
+  }
+  return roundedValue;
+}
 function formatScoreChange(diff) {
   const marker = getDiffMarker(diff);
-  const text = formatDiffNumber(Math.round(diff * 1e3) / 10);
+  const text = formatDiffNumber(roundValue(diff * 100));
   return colorByScoreDiff(`${marker} ${text}`, diff);
 }
 function formatValueChange({
@@ -849,7 +878,7 @@ function formatValueChange({
   scores
 }) {
   const marker = getDiffMarker(values.diff);
-  const percentage = values.before === 0 ? values.diff > 0 ? Number.POSITIVE_INFINITY : Number.NEGATIVE_INFINITY : Math.round(100 * values.diff / values.before);
+  const percentage = values.before === 0 ? values.diff > 0 ? Number.POSITIVE_INFINITY : Number.NEGATIVE_INFINITY : roundValue(values.diff / values.before * 100);
   const text = `${formatDiffNumber(percentage)}\u2009%`;
   return colorByScoreDiff(`${marker} ${text}`, scores.diff);
 }
@@ -880,12 +909,12 @@ function countCategoryAudits(refs, plugins) {
   }, 0);
 }
 function compareCategoryAuditsAndGroups(a, b) {
-  if (a.weight !== b.weight) {
-    return b.weight - a.weight;
-  }
   if (a.score !== b.score) {
     return a.score - b.score;
   }
+  if (a.weight !== b.weight) {
+    return b.weight - a.weight;
+  }
   if ("value" in a && "value" in b && a.value !== b.value) {
     return b.value - a.value;
   }
@@ -977,25 +1006,29 @@ var ProcessError = class extends Error {
   }
 };
 function executeProcess(cfg) {
-  const { observer, cwd, command: command2, args, ignoreExitCode = false } = cfg;
-  const { onStdout, onError, onComplete } = observer ?? {};
+  const { command: command2, args, observer, ignoreExitCode = false, ...options2 } = cfg;
+  const { onStdout, onStderr, onError, onComplete } = observer ?? {};
   const date = (/* @__PURE__ */ new Date()).toISOString();
   const start = performance.now();
   return new Promise((resolve, reject) => {
-    const process2 = spawn(command2, args, { cwd, shell: true });
+    const spawnedProcess = spawn(command2, args ?? [], {
+      shell: true,
+      ...options2
+    });
     let stdout = "";
     let stderr = "";
-    process2.stdout.on("data", (data) => {
+    spawnedProcess.stdout.on("data", (data) => {
       stdout += String(data);
-      onStdout?.(String(data));
+      onStdout?.(String(data), spawnedProcess);
     });
-    process2.stderr.on("data", (data) => {
+    spawnedProcess.stderr.on("data", (data) => {
       stderr += String(data);
+      onStderr?.(String(data), spawnedProcess);
     });
-    process2.on("error", (err) => {
+    spawnedProcess.on("error", (err) => {
       stderr += err.toString();
     });
-    process2.on("close", (code2) => {
+    spawnedProcess.on("close", (code2) => {
       const timings = { date, duration: calcDuration(start) };
       if (code2 === 0 || ignoreExitCode) {
         onComplete?.();
@@ -1569,7 +1602,33 @@ function getColumnAlignments(tableData) {
 }
 
 // packages/utils/src/lib/reports/formatting.ts
-import { MarkdownDocument, md as md2 } from "build-md";
+import {
+  MarkdownDocument,
+  md as md2
+} from "build-md";
+import { posix as pathPosix } from "node:path";
+
+// packages/utils/src/lib/reports/ide-environment.ts
+function getEnvironmentType() {
+  if (isVSCode()) {
+    return "vscode";
+  }
+  if (isGitHub()) {
+    return "github";
+  }
+  return "other";
+}
+function isVSCode() {
+  return process.env["TERM_PROGRAM"] === "vscode";
+}
+function isGitHub() {
+  return process.env["GITHUB_ACTIONS"] === "true";
+}
+function getGitHubBaseUrl() {
+  return `${process.env["GITHUB_SERVER_URL"]}/${process.env["GITHUB_REPOSITORY"]}/blob/${process.env["GITHUB_SHA"]}`;
+}
+
+// packages/utils/src/lib/reports/formatting.ts
 function tableSection(tableData, options2) {
   if (tableData.rows.length === 0) {
     return null;
@@ -1607,6 +1666,44 @@ function metaDescription(audit) {
   }
   return "";
 }
+function linkToLocalSourceForIde(source, options2) {
+  const { file, position } = source;
+  const { outputDir } = options2 ?? {};
+  if (!outputDir) {
+    return md2.code(file);
+  }
+  return md2.link(formatFileLink(file, position, outputDir), md2.code(file));
+}
+function formatSourceLine(position) {
+  if (!position) {
+    return "";
+  }
+  const { startLine, endLine } = position;
+  return endLine && startLine !== endLine ? `${startLine}-${endLine}` : `${startLine}`;
+}
+function formatGitHubLink(file, position) {
+  const baseUrl = getGitHubBaseUrl();
+  if (!position) {
+    return `${baseUrl}/${file}`;
+  }
+  const { startLine, endLine, startColumn, endColumn } = position;
+  const start = startColumn ? `L${startLine}C${startColumn}` : `L${startLine}`;
+  const end = endLine ? endColumn ? `L${endLine}C${endColumn}` : `L${endLine}` : "";
+  const lineRange = end && start !== end ? `${start}-${end}` : start;
+  return `${baseUrl}/${file}#${lineRange}`;
+}
+function formatFileLink(file, position, outputDir) {
+  const relativePath = pathPosix.relative(outputDir, file);
+  const env = getEnvironmentType();
+  switch (env) {
+    case "vscode":
+      return position ? `${relativePath}#L${position.startLine}` : relativePath;
+    case "github":
+      return formatGitHubLink(file, position);
+    default:
+      return relativePath;
+  }
+}
 
 // packages/utils/src/lib/reports/generate-md-report-categoy-section.ts
 import { MarkdownDocument as MarkdownDocument2, md as md3 } from "build-md";
@@ -1808,16 +1905,16 @@ function auditDetailsAuditValue({
     String(displayValue ?? value)
   )} (score: ${formatReportScore(score)})`;
 }
-function generateMdReport(report) {
+function generateMdReport(report, options2) {
   return new MarkdownDocument3().heading(HIERARCHY.level_1, REPORT_HEADLINE_TEXT).$if(
     report.categories.length > 0,
     (doc) => doc.$concat(
       categoriesOverviewSection(report),
       categoriesDetailsSection(report)
     )
-  ).$concat(auditsSection(report), aboutSection(report)).rule().paragraph(md4`${FOOTER_PREFIX} ${md4.link(README_LINK, "Code PushUp")}`).toString();
+  ).$concat(auditsSection(report, options2), aboutSection(report)).rule().paragraph(md4`${FOOTER_PREFIX} ${md4.link(README_LINK, "Code PushUp")}`).toString();
 }
-function auditDetailsIssues(issues = []) {
+function auditDetailsIssues(issues = [], options2) {
   if (issues.length === 0) {
     return null;
   }
@@ -1833,39 +1930,36 @@ function auditDetailsIssues(issues = []) {
       if (!source) {
         return [severity, message];
       }
-      const file = md4.code(source.file);
+      const file = linkToLocalSourceForIde(source, options2);
       if (!source.position) {
         return [severity, message, file];
       }
-      const { startLine, endLine } = source.position;
-      const line = `${startLine || ""}${endLine && startLine !== endLine ? `-${endLine}` : ""}`;
+      const line = formatSourceLine(source.position);
       return [severity, message, file, line];
     })
   );
 }
-function auditDetails(audit) {
+function auditDetails(audit, options2) {
   const { table: table2, issues = [] } = audit.details ?? {};
   const detailsValue = auditDetailsAuditValue(audit);
   if (issues.length === 0 && !table2?.rows.length) {
     return new MarkdownDocument3().paragraph(detailsValue);
   }
   const tableSectionContent = table2 && tableSection(table2);
-  const issuesSectionContent = issues.length > 0 && auditDetailsIssues(issues);
+  const issuesSectionContent = issues.length > 0 && auditDetailsIssues(issues, options2);
   return new MarkdownDocument3().details(
     detailsValue,
     new MarkdownDocument3().$concat(tableSectionContent, issuesSectionContent)
   );
 }
-function auditsSection({
-  plugins
-}) {
+function auditsSection({ plugins }, options2) {
   return new MarkdownDocument3().heading(HIERARCHY.level_2, "\u{1F6E1}\uFE0F Audits").$foreach(
     plugins.flatMap(
       (plugin) => plugin.audits.map((audit) => ({ ...audit, plugin }))
     ),
     (doc, { plugin, ...audit }) => {
       const auditTitle = `${audit.title} (${plugin.title})`;
-      const detailsContent = auditDetails(audit);
+      const detailsContent = auditDetails(audit, options2);
       const descriptionContent = metaDescription(audit);
       return doc.heading(HIERARCHY.level_3, auditTitle).$concat(detailsContent).paragraph(descriptionContent);
     }
@@ -1890,17 +1984,17 @@ function pluginMetaTable({
       { heading: "Version", alignment: "center" },
       { heading: "Duration", alignment: "right" }
     ],
-    plugins.map(({ title, audits, version: version2 = "", duration }) => [
+    plugins.map(({ title, audits, version: version3 = "", duration }) => [
       title,
       audits.length.toString(),
-      version2 && md4.code(version2),
+      version3 && md4.code(version3),
       formatDuration(duration)
     ])
   ];
 }
 function reportMetaTable({
   commit,
-  version: version2,
+  version: version3,
   duration,
   plugins,
   categories
@@ -1917,7 +2011,7 @@ function reportMetaTable({
     [
       [
         commit ? `${commit.message} (${commit.hash})` : "N/A",
-        md4.code(version2),
+        md4.code(version3),
         formatDuration(duration),
         plugins.length.toString(),
         categories.length.toString(),
@@ -1929,19 +2023,111 @@ function reportMetaTable({
 
 // packages/utils/src/lib/reports/generate-md-reports-diff.ts
 import {
-  MarkdownDocument as MarkdownDocument4,
-  md as md5
+  MarkdownDocument as MarkdownDocument5,
+  md as md6
 } from "build-md";
+
+// packages/utils/src/lib/reports/generate-md-reports-diff-utils.ts
+import { MarkdownDocument as MarkdownDocument4, md as md5 } from "build-md";
 var MAX_ROWS = 100;
-function generateMdReportsDiff(diff, portalUrl) {
-  return new MarkdownDocument4().$concat(
-    createDiffHeaderSection(diff, portalUrl),
-    createDiffCategoriesSection(diff),
-    createDiffGroupsSection(diff),
-    createDiffAuditsSection(diff)
-  ).toString();
+function summarizeUnchanged(token, { changed, unchanged }) {
+  const pluralizedCount = changed.length > 0 ? pluralizeToken(`other ${token}`, unchanged.length) : `All of ${pluralizeToken(token, unchanged.length)}`;
+  const pluralizedVerb = unchanged.length === 1 ? "is" : "are";
+  return `${pluralizedCount} ${pluralizedVerb} unchanged.`;
+}
+function summarizeDiffOutcomes(outcomes, token) {
+  return objectToEntries(countDiffOutcomes(outcomes)).filter(
+    (entry) => entry[0] !== "unchanged" && entry[1] > 0
+  ).map(([outcome, count]) => {
+    const formattedCount = `<strong>${count}</strong> ${pluralize(
+      token,
+      count
+    )}`;
+    switch (outcome) {
+      case "positive":
+        return `\u{1F44D} ${formattedCount} improved`;
+      case "negative":
+        return `\u{1F44E} ${formattedCount} regressed`;
+      case "mixed":
+        return `${formattedCount} changed without impacting score`;
+    }
+  }).join(", ");
+}
+function createGroupsOrAuditsDetails(token, { changed, unchanged }, ...[columns, rows]) {
+  if (changed.length === 0) {
+    return new MarkdownDocument4().paragraph(
+      summarizeUnchanged(token, { changed, unchanged })
+    );
+  }
+  return new MarkdownDocument4().table(columns, rows.slice(0, MAX_ROWS)).paragraph(
+    changed.length > MAX_ROWS && md5.italic(
+      `Only the ${MAX_ROWS} most affected ${pluralize(
+        token
+      )} are listed above for brevity.`
+    )
+  ).paragraph(
+    unchanged.length > 0 && summarizeUnchanged(token, { changed, unchanged })
+  );
+}
+function formatTitle({
+  title,
+  docsUrl
+}) {
+  if (docsUrl) {
+    return md5.link(docsUrl, title);
+  }
+  return title;
+}
+function formatPortalLink(portalUrl) {
+  return portalUrl && md5.link(portalUrl, "\u{1F575}\uFE0F See full comparison in Code PushUp portal \u{1F50D}");
+}
+function sortChanges(changes) {
+  return [...changes].sort(
+    (a, b) => Math.abs(b.scores.diff) - Math.abs(a.scores.diff) || Math.abs(b.values?.diff ?? 0) - Math.abs(a.values?.diff ?? 0)
+  );
+}
+function getDiffChanges(diff) {
+  return [
+    ...diff.categories.changed,
+    ...diff.groups.changed,
+    ...diff.audits.changed
+  ];
+}
+function changesToDiffOutcomes(changes) {
+  return changes.map((change) => {
+    if (change.scores.diff > 0) {
+      return "positive";
+    }
+    if (change.scores.diff < 0) {
+      return "negative";
+    }
+    if (change.values != null && change.values.diff !== 0) {
+      return "mixed";
+    }
+    return "unchanged";
+  });
 }
-function createDiffHeaderSection(diff, portalUrl) {
+function mergeDiffOutcomes(outcomes) {
+  if (outcomes.every((outcome) => outcome === "unchanged")) {
+    return "unchanged";
+  }
+  if (outcomes.includes("positive") && !outcomes.includes("negative")) {
+    return "positive";
+  }
+  if (outcomes.includes("negative") && !outcomes.includes("positive")) {
+    return "negative";
+  }
+  return "mixed";
+}
+function countDiffOutcomes(outcomes) {
+  return {
+    positive: outcomes.filter((outcome) => outcome === "positive").length,
+    negative: outcomes.filter((outcome) => outcome === "negative").length,
+    mixed: outcomes.filter((outcome) => outcome === "mixed").length,
+    unchanged: outcomes.filter((outcome) => outcome === "unchanged").length
+  };
+}
+function formatReportOutcome(outcome, commits) {
   const outcomeTexts = {
     positive: md5`🥳 Code PushUp report has ${md5.bold("improved")}`,
     negative: md5`😟 Code PushUp report has ${md5.bold("regressed")}`,
@@ -1950,36 +2136,91 @@ function createDiffHeaderSection(diff, portalUrl) {
     )}`,
     unchanged: md5`😐 Code PushUp report is ${md5.bold("unchanged")}`
   };
+  if (commits) {
+    const commitsText = `compared target commit ${commits.after.hash} with source commit ${commits.before.hash}`;
+    return md5`${outcomeTexts[outcome]} – ${commitsText}.`;
+  }
+  return md5`${outcomeTexts[outcome]}.`;
+}
+function compareDiffsBy(type, a, b) {
+  return sumScoreChanges(b[type].changed) - sumScoreChanges(a[type].changed) || sumConfigChanges(b[type]) - sumConfigChanges(a[type]);
+}
+function sumScoreChanges(changes) {
+  return changes.reduce(
+    (acc, { scores }) => acc + Math.abs(scores.diff),
+    0
+  );
+}
+function sumConfigChanges({
+  added,
+  removed
+}) {
+  return added.length + removed.length;
+}
+
+// packages/utils/src/lib/reports/generate-md-reports-diff.ts
+function generateMdReportsDiff(diff) {
+  return new MarkdownDocument5().$concat(
+    createDiffHeaderSection(diff),
+    createDiffCategoriesSection(diff),
+    createDiffDetailsSection(diff)
+  ).toString();
+}
+function generateMdReportsDiffForMonorepo(diffs) {
+  const diffsWithOutcomes = diffs.map((diff) => ({
+    ...diff,
+    outcome: mergeDiffOutcomes(changesToDiffOutcomes(getDiffChanges(diff)))
+  })).sort(
+    (a, b) => compareDiffsBy("categories", a, b) || compareDiffsBy("groups", a, b) || compareDiffsBy("audits", a, b) || a.label.localeCompare(b.label)
+  );
+  const unchanged = diffsWithOutcomes.filter(
+    ({ outcome }) => outcome === "unchanged"
+  );
+  const changed = diffsWithOutcomes.filter((diff) => !unchanged.includes(diff));
+  return new MarkdownDocument5().$concat(
+    createDiffHeaderSection(diffs),
+    ...changed.map(createDiffProjectSection)
+  ).$if(
+    unchanged.length > 0,
+    (doc) => doc.rule().paragraph(summarizeUnchanged("project", { unchanged, changed }))
+  ).toString();
+}
+function createDiffHeaderSection(diff) {
   const outcome = mergeDiffOutcomes(
-    changesToDiffOutcomes([
-      ...diff.categories.changed,
-      ...diff.groups.changed,
-      ...diff.audits.changed
-    ])
+    changesToDiffOutcomes(toArray(diff).flatMap(getDiffChanges))
   );
-  const styleCommits = (commits) => `compared target commit ${commits.after.hash} with source commit ${commits.before.hash}`;
-  return new MarkdownDocument4().heading(HIERARCHY.level_1, "Code PushUp").paragraph(
-    diff.commits ? md5`${outcomeTexts[outcome]} – ${styleCommits(diff.commits)}.` : outcomeTexts[outcome]
-  ).paragraph(
-    portalUrl && md5.link(portalUrl, "\u{1F575}\uFE0F See full comparison in Code PushUp portal \u{1F50D}")
+  const commits = Array.isArray(diff) ? diff[0]?.commits : diff.commits;
+  const portalUrl = Array.isArray(diff) ? void 0 : diff.portalUrl;
+  return new MarkdownDocument5().heading(HIERARCHY.level_1, "Code PushUp").paragraph(formatReportOutcome(outcome, commits)).paragraph(formatPortalLink(portalUrl));
+}
+function createDiffProjectSection(diff) {
+  return new MarkdownDocument5().heading(HIERARCHY.level_2, md6`💼 Project ${md6.code(diff.label)}`).paragraph(formatReportOutcome(diff.outcome)).paragraph(formatPortalLink(diff.portalUrl)).$concat(
+    createDiffCategoriesSection(diff, {
+      skipHeading: true,
+      skipUnchanged: true
+    }),
+    createDiffDetailsSection(diff, HIERARCHY.level_3)
   );
 }
-function createDiffCategoriesSection(diff) {
+function createDiffCategoriesSection(diff, options2) {
   const { changed, unchanged, added } = diff.categories;
+  const { skipHeading, skipUnchanged } = options2 ?? {};
   const categoriesCount = changed.length + unchanged.length + added.length;
   const hasChanges = unchanged.length < categoriesCount;
   if (categoriesCount === 0) {
     return null;
   }
-  const columns = [
-    { heading: "\u{1F3F7}\uFE0F Category", alignment: "left" },
-    {
-      heading: hasChanges ? "\u2B50 Previous score" : "\u2B50 Score",
-      alignment: "center"
-    },
-    { heading: "\u2B50 Current score", alignment: "center" },
-    { heading: "\u{1F504} Score change", alignment: "center" }
-  ];
+  const [columns, rows] = createCategoriesTable(diff, {
+    hasChanges,
+    skipUnchanged
+  });
+  return new MarkdownDocument5().heading(HIERARCHY.level_2, !skipHeading && "\u{1F3F7}\uFE0F Categories").table(columns, rows).paragraph(added.length > 0 && md6.italic("(\\*) New category.")).paragraph(
+    skipUnchanged && unchanged.length > 0 && summarizeUnchanged("category", { changed, unchanged })
+  );
+}
+function createCategoriesTable(diff, options2) {
+  const { changed, unchanged, added } = diff.categories;
+  const { hasChanges, skipUnchanged } = options2;
   const rows = [
     ...sortChanges(changed).map((category) => [
       formatTitle(category),
@@ -1991,27 +2232,55 @@ function createDiffCategoriesSection(diff) {
     ]),
     ...added.map((category) => [
       formatTitle(category),
-      md5.italic("n/a (\\*)"),
+      md6.italic("n/a (\\*)"),
       formatScoreWithColor(category.score),
-      md5.italic("n/a (\\*)")
+      md6.italic("n/a (\\*)")
     ]),
-    ...unchanged.map((category) => [
+    ...skipUnchanged ? [] : unchanged.map((category) => [
       formatTitle(category),
       formatScoreWithColor(category.score, { skipBold: true }),
       formatScoreWithColor(category.score),
       "\u2013"
     ])
   ];
-  return new MarkdownDocument4().heading(HIERARCHY.level_2, "\u{1F3F7}\uFE0F Categories").table(
+  if (rows.length === 0) {
+    return [[], []];
+  }
+  const columns = [
+    { heading: "\u{1F3F7}\uFE0F Category", alignment: "left" },
+    {
+      heading: hasChanges ? "\u2B50 Previous score" : "\u2B50 Score",
+      alignment: "center"
+    },
+    { heading: "\u2B50 Current score", alignment: "center" },
+    { heading: "\u{1F504} Score change", alignment: "center" }
+  ];
+  return [
     hasChanges ? columns : columns.slice(0, 2),
     rows.map((row) => hasChanges ? row : row.slice(0, 2))
-  ).paragraph(added.length > 0 && md5.italic("(\\*) New category."));
+  ];
+}
+function createDiffDetailsSection(diff, level = HIERARCHY.level_2) {
+  if (diff.groups.changed.length + diff.audits.changed.length === 0) {
+    return null;
+  }
+  const summary = ["group", "audit"].map(
+    (token) => summarizeDiffOutcomes(
+      changesToDiffOutcomes(diff[`${token}s`].changed),
+      token
+    )
+  ).filter(Boolean).join(", ");
+  const details2 = new MarkdownDocument5().$concat(
+    createDiffGroupsSection(diff, level),
+    createDiffAuditsSection(diff, level)
+  );
+  return new MarkdownDocument5().details(summary, details2);
 }
-function createDiffGroupsSection(diff) {
+function createDiffGroupsSection(diff, level) {
   if (diff.groups.changed.length + diff.groups.unchanged.length === 0) {
     return null;
   }
-  return new MarkdownDocument4().heading(HIERARCHY.level_2, "\u{1F5C3}\uFE0F Groups").$concat(
+  return new MarkdownDocument5().heading(level, "\u{1F5C3}\uFE0F Groups").$concat(
     createGroupsOrAuditsDetails(
       "group",
       diff.groups,
@@ -2032,8 +2301,8 @@ function createDiffGroupsSection(diff) {
     )
   );
 }
-function createDiffAuditsSection(diff) {
-  return new MarkdownDocument4().heading(HIERARCHY.level_2, "\u{1F6E1}\uFE0F Audits").$concat(
+function createDiffAuditsSection(diff, level) {
+  return new MarkdownDocument5().heading(level, "\u{1F6E1}\uFE0F Audits").$concat(
     createGroupsOrAuditsDetails(
       "audit",
       diff.audits,
@@ -2048,7 +2317,7 @@ function createDiffAuditsSection(diff) {
         formatTitle(audit.plugin),
         formatTitle(audit),
         `${scoreMarker(audit.scores.before, "square")} ${audit.displayValues.before || audit.values.before.toString()}`,
-        md5`${scoreMarker(audit.scores.after, "square")} ${md5.bold(
+        md6`${scoreMarker(audit.scores.after, "square")} ${md6.bold(
           audit.displayValues.after || audit.values.after.toString()
         )}`,
         formatValueChange(audit)
@@ -2056,96 +2325,6 @@ function createDiffAuditsSection(diff) {
     )
   );
 }
-function createGroupsOrAuditsDetails(token, { changed, unchanged }, ...[columns, rows]) {
-  if (changed.length === 0) {
-    return new MarkdownDocument4().paragraph(
-      summarizeUnchanged(token, { changed, unchanged })
-    );
-  }
-  return new MarkdownDocument4().details(
-    summarizeDiffOutcomes(changesToDiffOutcomes(changed), token),
-    md5`${md5.table(columns, rows.slice(0, MAX_ROWS))}${changed.length > MAX_ROWS ? md5.paragraph(
-      md5.italic(
-        `Only the ${MAX_ROWS} most affected ${pluralize(
-          token
-        )} are listed above for brevity.`
-      )
-    ) : ""}${unchanged.length > 0 ? md5.paragraph(summarizeUnchanged(token, { changed, unchanged })) : ""}`
-  );
-}
-function summarizeUnchanged(token, { changed, unchanged }) {
-  return [
-    changed.length > 0 ? pluralizeToken(`other ${token}`, unchanged.length) : `All of ${pluralizeToken(token, unchanged.length)}`,
-    unchanged.length === 1 ? "is" : "are",
-    "unchanged."
-  ].join(" ");
-}
-function summarizeDiffOutcomes(outcomes, token) {
-  return objectToEntries(countDiffOutcomes(outcomes)).filter(
-    (entry) => entry[0] !== "unchanged" && entry[1] > 0
-  ).map(([outcome, count]) => {
-    const formattedCount = `<strong>${count}</strong> ${pluralize(
-      token,
-      count
-    )}`;
-    switch (outcome) {
-      case "positive":
-        return `\u{1F44D} ${formattedCount} improved`;
-      case "negative":
-        return `\u{1F44E} ${formattedCount} regressed`;
-      case "mixed":
-        return `${formattedCount} changed without impacting score`;
-    }
-  }).join(", ");
-}
-function formatTitle({
-  title,
-  docsUrl
-}) {
-  if (docsUrl) {
-    return md5.link(docsUrl, title);
-  }
-  return title;
-}
-function sortChanges(changes) {
-  return [...changes].sort(
-    (a, b) => Math.abs(b.scores.diff) - Math.abs(a.scores.diff) || Math.abs(b.values?.diff ?? 0) - Math.abs(a.values?.diff ?? 0)
-  );
-}
-function changesToDiffOutcomes(changes) {
-  return changes.map((change) => {
-    if (change.scores.diff > 0) {
-      return "positive";
-    }
-    if (change.scores.diff < 0) {
-      return "negative";
-    }
-    if (change.values != null && change.values.diff !== 0) {
-      return "mixed";
-    }
-    return "unchanged";
-  });
-}
-function mergeDiffOutcomes(outcomes) {
-  if (outcomes.every((outcome) => outcome === "unchanged")) {
-    return "unchanged";
-  }
-  if (outcomes.includes("positive") && !outcomes.includes("negative")) {
-    return "positive";
-  }
-  if (outcomes.includes("negative") && !outcomes.includes("positive")) {
-    return "negative";
-  }
-  return "mixed";
-}
-function countDiffOutcomes(outcomes) {
-  return {
-    positive: outcomes.filter((outcome) => outcome === "positive").length,
-    negative: outcomes.filter((outcome) => outcome === "negative").length,
-    mixed: outcomes.filter((outcome) => outcome === "mixed").length,
-    unchanged: outcomes.filter((outcome) => outcome === "unchanged").length
-  };
-}
 
 // packages/utils/src/lib/reports/load-report.ts
 import { join as join2 } from "node:path";
@@ -2178,8 +2357,8 @@ function logStdoutSummary(report) {
   log();
 }
 function reportToHeaderSection(report) {
-  const { packageName, version: version2 } = report;
-  return `${bold4(REPORT_HEADLINE_TEXT)} - ${packageName}@${version2}`;
+  const { packageName, version: version3 } = report;
+  return `${bold4(REPORT_HEADLINE_TEXT)} - ${packageName}@${version3}`;
 }
 function logPlugins(report) {
   const { plugins } = report;
@@ -2202,7 +2381,8 @@ function logPlugins(report) {
         },
         {
           text: cyanBright(audit.displayValue || `${audit.value}`),
-          width: 10,
+          // eslint-disable-next-line no-magic-numbers
+          width: 20,
           padding: [0, 0, 0, 0]
         }
       ]);
@@ -2355,7 +2535,7 @@ var verboseUtils = (verbose = false) => ({
 
 // packages/core/package.json
 var name = "@code-pushup/core";
-var version = "0.49.0";
+var version = "0.51.0";
 
 // packages/core/src/lib/implementation/execute-plugin.ts
 import { bold as bold5 } from "ansis";
@@ -2564,7 +2744,7 @@ async function persistReport(report, options2) {
       case "md":
         return {
           format: "md",
-          content: generateMdReport(sortedScoredReport)
+          content: generateMdReport(sortedScoredReport, { outputDir })
         };
     }
   });
@@ -2751,7 +2931,7 @@ function selectMeta(meta) {
 }
 
 // packages/core/src/lib/compare.ts
-async function compareReportFiles(inputPaths, persistConfig, uploadConfig) {
+async function compareReportFiles(inputPaths, persistConfig, uploadConfig, label) {
   const { outputDir, filename, format } = persistConfig;
   const [reportBefore, reportAfter] = await Promise.all([
     readJsonFile(inputPaths.before),
@@ -2761,12 +2941,20 @@ async function compareReportFiles(inputPaths, persistConfig, uploadConfig) {
     before: reportSchema.parse(reportBefore),
     after: reportSchema.parse(reportAfter)
   };
-  const reportsDiff = compareReports(reports);
-  const portalUrl = uploadConfig && reportsDiff.commits && format.includes("md") ? await fetchPortalComparisonLink(uploadConfig, reportsDiff.commits) : void 0;
+  const diff = compareReports(reports);
+  if (label) {
+    diff.label = label;
+  }
+  if (uploadConfig && diff.commits) {
+    diff.portalUrl = await fetchPortalComparisonLink(
+      uploadConfig,
+      diff.commits
+    );
+  }
   return Promise.all(
     format.map(async (fmt) => {
       const outputPath = join5(outputDir, `${filename}-diff.${fmt}`);
-      const content = reportsDiffToFileContent(reportsDiff, fmt, portalUrl);
+      const content = reportsDiffToFileContent(diff, fmt);
       await ensureDirectoryExists(outputDir);
       await writeFile2(outputPath, content);
       return outputPath;
@@ -2796,12 +2984,12 @@ function compareReports(reports) {
     duration
   };
 }
-function reportsDiffToFileContent(reportsDiff, format, portalUrl) {
+function reportsDiffToFileContent(reportsDiff, format) {
   switch (format) {
     case "json":
       return JSON.stringify(reportsDiff, null, 2);
     case "md":
-      return generateMdReportsDiff(reportsDiff, portalUrl ?? void 0);
+      return generateMdReportsDiff(reportsDiff);
   }
 }
 async function fetchPortalComparisonLink(uploadConfig, commits) {
@@ -3074,6 +3262,45 @@ async function autoloadRc(tsconfig) {
   );
 }
 
+// packages/core/src/lib/merge-diffs.ts
+import { writeFile as writeFile3 } from "node:fs/promises";
+import { basename, dirname, join as join7 } from "node:path";
+async function mergeDiffs(files, persistConfig) {
+  const results = await Promise.allSettled(
+    files.map(async (file) => {
+      const json = await readJsonFile(file).catch((error) => {
+        throw new Error(
+          `Failed to read JSON file ${file} - ${stringifyError(error)}`
+        );
+      });
+      const result = await reportsDiffSchema.safeParseAsync(json);
+      if (!result.success) {
+        throw new Error(
+          `Invalid reports diff in ${file} - ${result.error.message}`
+        );
+      }
+      return { ...result.data, file };
+    })
+  );
+  results.filter(isPromiseRejectedResult).forEach(({ reason }) => {
+    ui().logger.warning(
+      `Skipped invalid report diff - ${stringifyError(reason)}`
+    );
+  });
+  const diffs = results.filter(isPromiseFulfilledResult).map(({ value }) => value);
+  const labeledDiffs = diffs.map((diff) => ({
+    ...diff,
+    label: diff.label || basename(dirname(diff.file))
+    // fallback is parent folder name
+  }));
+  const markdown = generateMdReportsDiffForMonorepo(labeledDiffs);
+  const { outputDir, filename } = persistConfig;
+  const outputPath = join7(outputDir, `${filename}-diff.md`);
+  await ensureDirectoryExists(outputDir);
+  await writeFile3(outputPath, markdown);
+  return outputPath;
+}
+
 // packages/cli/src/lib/constants.ts
 var CLI_NAME = "Code PushUp CLI";
 var CLI_SCRIPT_NAME = "code-pushup";
@@ -3207,6 +3434,10 @@ function yargsCompareOptionsDefinition() {
       describe: "Path to target report.json",
       type: "string",
       demandOption: true
+    },
+    label: {
+      describe: "Label for diff (e.g. project name)",
+      type: "string"
     }
   };
 }
@@ -3222,11 +3453,12 @@ function yargsCompareCommandObject() {
       ui().logger.log(bold9(CLI_NAME));
       ui().logger.info(gray6(`Run ${command2}...`));
       const options2 = args;
-      const { before, after, persist, upload: upload2 } = options2;
+      const { before, after, label, persist, upload: upload2 } = options2;
       const outputPaths = await compareReportFiles(
         { before, after },
         persist,
-        upload2
+        upload2,
+        label
       );
       ui().logger.info(
         `Reports diff written to ${outputPaths.map((path) => bold9(path)).join(" and ")}`
@@ -3268,7 +3500,8 @@ var onlyPluginsOption = {
   describe: "List of plugins to run. If not set all plugins are run.",
   type: "array",
   default: [],
-  coerce: coerceArray
+  coerce: coerceArray,
+  alias: "p"
 };
 function yargsOnlyPluginsOptionsDefinition() {
   return {
@@ -3281,7 +3514,8 @@ var skipPluginsOption = {
   describe: "List of plugins to skip. If not set all plugins are run.",
   type: "array",
   default: [],
-  coerce: coerceArray
+  coerce: coerceArray,
+  alias: "P"
 };
 function yargsSkipPluginsOptionsDefinition() {
   return {
@@ -3412,6 +3646,38 @@ function yargsHistoryCommandObject() {
   };
 }
 
+// packages/cli/src/lib/merge-diffs/merge-diffs-command.ts
+import { bold as bold11, gray as gray8 } from "ansis";
+
+// packages/cli/src/lib/implementation/merge-diffs.options.ts
+function yargsMergeDiffsOptionsDefinition() {
+  return {
+    files: {
+      describe: "List of report-diff.json paths",
+      type: "array",
+      demandOption: true
+    }
+  };
+}
+
+// packages/cli/src/lib/merge-diffs/merge-diffs-command.ts
+function yargsMergeDiffsCommandObject() {
+  const command2 = "merge-diffs";
+  return {
+    command: command2,
+    describe: "Combine many report diffs into a single diff file",
+    builder: yargsMergeDiffsOptionsDefinition(),
+    handler: async (args) => {
+      ui().logger.log(bold11(CLI_NAME));
+      ui().logger.info(gray8(`Run ${command2}...`));
+      const options2 = args;
+      const { files, persist } = options2;
+      const outputPath = await mergeDiffs(files, persist);
+      ui().logger.info(`Reports diff written to ${bold11(outputPath)}`);
+    }
+  };
+}
+
 // packages/cli/src/lib/print-config/print-config-command.ts
 function yargsConfigCommandObject() {
   const command2 = "print-config";
@@ -3427,15 +3693,15 @@ function yargsConfigCommandObject() {
 }
 
 // packages/cli/src/lib/upload/upload-command.ts
-import { bold as bold11, gray as gray8 } from "ansis";
+import { bold as bold12, gray as gray9 } from "ansis";
 function yargsUploadCommandObject() {
   const command2 = "upload";
   return {
     command: command2,
     describe: "Upload report results to the portal",
     handler: async (args) => {
-      ui().logger.log(bold11(CLI_NAME));
-      ui().logger.info(gray8(`Run ${command2}...`));
+      ui().logger.log(bold12(CLI_NAME));
+      ui().logger.info(gray9(`Run ${command2}...`));
       const options2 = args;
       if (options2.upload == null) {
         renderIntegratePortalHint();
@@ -3458,7 +3724,8 @@ var commands = [
   yargsUploadCommandObject(),
   yargsHistoryCommandObject(),
   yargsCompareCommandObject(),
-  yargsConfigCommandObject()
+  yargsConfigCommandObject(),
+  yargsMergeDiffsCommandObject()
 ];
 
 // packages/cli/src/lib/implementation/core-config.middleware.ts
@@ -3499,7 +3766,6 @@ async function coreConfigMiddleware(processArgs) {
 var normalizeFormats = (formats) => (formats ?? []).flatMap((format) => format.split(","));
 
 // packages/cli/src/lib/implementation/validate-plugin-filter-options.utils.ts
-import { yellow } from "ansis";
 function validatePluginFilterOption(filterOption, {
   plugins,
   categories
@@ -3513,13 +3779,9 @@ function validatePluginFilterOption(filterOption, {
   );
   const isSkipOption = filterOption === "skipPlugins";
   const filterFunction = (plugin) => isSkipOption ? pluginsToFilterSet.has(plugin) : !pluginsToFilterSet.has(plugin);
-  if (missingPlugins.length > 0 && verbose) {
-    ui().logger.info(
-      `${yellow(
-        "\u26A0"
-      )} The --${filterOption} argument references plugins with "${missingPlugins.join(
-        '", "'
-      )}" slugs, but no such plugins are present in the configuration. Expected one of the following plugin slugs: "${plugins.map(({ slug }) => slug).join('", "')}".`
+  if (missingPlugins.length > 0) {
+    ui().logger.warning(
+      `The --${filterOption} argument references ${missingPlugins.length === 1 ? "a plugin that does" : "plugins that do"} not exist: ${missingPlugins.join(", ")}. The valid plugin ${plugins.length === 1 ? "slug is" : "slugs are"} ${plugins.map(({ slug }) => slug).join(", ")}.`
     );
   }
   if (categories.length > 0 && verbose) {
@@ -3528,71 +3790,53 @@ function validatePluginFilterOption(filterOption, {
       ({ plugin }) => filterFunction(plugin)
     ).map(({ slug }) => slug);
     ui().logger.info(
-      `The --${filterOption} argument removed categories with "${removedCategorySlugs.join(
-        '", "'
-      )}" slugs.
-    `
+      `The --${filterOption} argument removed the following categories: ${removedCategorySlugs.join(
+        ", "
+      )}.`
     );
   }
 }
 
-// packages/cli/src/lib/implementation/only-plugins.middleware.ts
-function onlyPluginsMiddleware(originalProcessArgs) {
-  const { categories = [], onlyPlugins: originalOnlyPlugins } = originalProcessArgs;
-  if (originalOnlyPlugins && originalOnlyPlugins.length > 0) {
-    const { verbose, plugins, onlyPlugins = [] } = originalProcessArgs;
-    validatePluginFilterOption(
-      "onlyPlugins",
-      { plugins, categories },
-      { pluginsToFilter: onlyPlugins, verbose }
-    );
-    const validOnlyPlugins = onlyPlugins.filter(
-      (oP) => plugins.find((p) => p.slug === oP)
-    );
-    const onlyPluginsSet = new Set(validOnlyPlugins);
-    return {
-      ...originalProcessArgs,
-      plugins: onlyPluginsSet.size > 0 ? plugins.filter(({ slug }) => onlyPluginsSet.has(slug)) : plugins,
-      categories: onlyPluginsSet.size > 0 ? filterItemRefsBy(
-        categories,
-        ({ plugin }) => onlyPluginsSet.has(plugin)
-      ) : categories
-    };
-  }
-  return {
-    ...originalProcessArgs,
-    // if undefined fill categories with empty array
-    categories
-  };
-}
-
-// packages/cli/src/lib/implementation/skip-plugins.middleware.ts
-function skipPluginsMiddleware(originalProcessArgs) {
-  const { categories = [], skipPlugins: originalSkipPlugins } = originalProcessArgs;
-  if (originalSkipPlugins && originalSkipPlugins.length > 0) {
-    const { verbose, plugins, skipPlugins = [] } = originalProcessArgs;
-    validatePluginFilterOption(
-      "skipPlugins",
-      { plugins, categories },
-      { pluginsToFilter: skipPlugins, verbose }
-    );
-    const validSkipPlugins = skipPlugins.filter(
-      (sP) => plugins.find((p) => p.slug === sP)
-    );
-    const skipPluginsSet = new Set(validSkipPlugins);
-    return {
-      ...originalProcessArgs,
-      plugins: skipPluginsSet.size > 0 ? plugins.filter(({ slug }) => !skipPluginsSet.has(slug)) : plugins,
-      categories: skipPluginsSet.size > 0 ? filterItemRefsBy(
-        categories,
-        ({ plugin }) => !skipPluginsSet.has(plugin)
-      ) : categories
-    };
+// packages/cli/src/lib/implementation/filter-plugins.middleware.ts
+function filterPluginsMiddleware(originalProcessArgs) {
+  const {
+    plugins,
+    categories = [],
+    skipPlugins = [],
+    onlyPlugins = [],
+    verbose
+  } = originalProcessArgs;
+  if (skipPlugins.length === 0 && onlyPlugins.length === 0) {
+    return { ...originalProcessArgs, categories };
   }
+  validatePluginFilterOption(
+    "skipPlugins",
+    { plugins, categories },
+    { pluginsToFilter: skipPlugins, verbose }
+  );
+  validatePluginFilterOption(
+    "onlyPlugins",
+    { plugins, categories },
+    { pluginsToFilter: onlyPlugins, verbose }
+  );
+  const validSkipPlugins = new Set(
+    skipPlugins.filter((sP) => plugins.some((p) => p.slug === sP))
+  );
+  const pluginsAfterSkip = plugins.filter(
+    ({ slug }) => !validSkipPlugins.has(slug)
+  );
+  const validOnlyPlugins = new Set(
+    onlyPlugins.filter((oP) => pluginsAfterSkip.some((p) => p.slug === oP))
+  );
+  const filteredPlugins = validOnlyPlugins.size > 0 ? pluginsAfterSkip.filter(({ slug }) => validOnlyPlugins.has(slug)) : pluginsAfterSkip;
+  const filteredCategories = filteredPlugins.length > 0 ? filterItemRefsBy(
+    categories,
+    ({ plugin }) => filteredPlugins.some(({ slug }) => slug === plugin)
+  ) : categories;
   return {
     ...originalProcessArgs,
-    // if undefined fill categories with empty array
-    categories
+    plugins: filteredPlugins,
+    categories: filteredCategories
   };
 }
 
@@ -3603,11 +3847,7 @@ var middlewares = [
     applyBeforeValidation: false
   },
   {
-    middlewareFunction: onlyPluginsMiddleware,
-    applyBeforeValidation: false
-  },
-  {
-    middlewareFunction: skipPluginsMiddleware,
+    middlewareFunction: filterPluginsMiddleware,
     applyBeforeValidation: false
   }
 ];
@@ -3670,7 +3910,7 @@ function yargsGlobalOptionsDefinition() {
       default: false
     },
     config: {
-      describe: "Path to config file, e.g. code-pushup.config.ts. By default it loads code-pushup.config.(ts|mjs|js).",
+      describe: "Path to config file. By default it loads code-pushup.config.(ts|mjs|js).",
       type: "string"
     },
     tsconfig: {
@@ -3698,8 +3938,55 @@ var groups = {
 };
 
 // packages/cli/src/lib/yargs-cli.ts
-import { bold as bold12 } from "ansis";
+import { blue, dim as dim2, green as green4 } from "ansis";
 import yargs from "yargs";
+
+// packages/cli/package.json
+var version2 = "0.51.0";
+
+// packages/cli/src/lib/implementation/formatting.ts
+import { bold as bold13, dim, green as green3 } from "ansis";
+function titleStyle(title) {
+  return `${bold13(title)}`;
+}
+function headerStyle(title) {
+  return `${green3(title)}`;
+}
+function descriptionStyle(title) {
+  return `${dim(title)}`;
+}
+function formatObjectValue(opts, propName) {
+  const description = opts[propName];
+  return {
+    ...opts,
+    ...typeof description === "string" && {
+      [propName]: descriptionStyle(description)
+    }
+  };
+}
+function formatNestedValues(options2, propName) {
+  return Object.fromEntries(
+    Object.entries(options2).map(([key, opts]) => [
+      key,
+      formatObjectValue(opts, propName)
+    ])
+  );
+}
+
+// packages/cli/src/lib/yargs-cli.ts
+var yargsDecorator = {
+  "Commands:": `${green4("Commands")}:`,
+  "Options:": `${green4("Options")}:`,
+  "Examples:": `${green4("Examples")}:`,
+  boolean: blue("boolean"),
+  count: blue("count"),
+  string: blue("string"),
+  array: blue("array"),
+  required: blue("required"),
+  "default:": `${blue("default")}:`,
+  "choices:": `${blue("choices")}:`,
+  "aliases:": `${blue("aliases")}:`
+};
 function yargsCli(argv, cfg) {
   const { usageMessage, scriptName, noExitProcess } = cfg;
   const commands2 = cfg.commands ?? [];
@@ -3708,7 +3995,7 @@ function yargsCli(argv, cfg) {
   const groups2 = cfg.groups ?? {};
   const examples = cfg.examples ?? [];
   const cli2 = yargs(argv);
-  cli2.help().version(false).alias("h", "help").check((args) => {
+  cli2.updateLocale(yargsDecorator).wrap(Math.max(TERMINAL_WIDTH, cli2.terminalWidth())).help("help", descriptionStyle("Show help")).alias("h", "help").showHelpOnFail(false).version("version", dim2`Show version`, version2).check((args) => {
     const persist = args["persist"];
     return persist == null || validatePersistFormat(persist);
   }).parserConfiguration({
@@ -3716,18 +4003,18 @@ function yargsCli(argv, cfg) {
   }).coerce(
     "config",
     (config) => Array.isArray(config) ? config.at(-1) : config
-  ).options(options2).wrap(TERMINAL_WIDTH);
+  ).options(formatNestedValues(options2, "describe"));
   if (usageMessage) {
-    cli2.usage(bold12(usageMessage));
+    cli2.usage(titleStyle(usageMessage));
   }
   if (scriptName) {
     cli2.scriptName(scriptName);
   }
   examples.forEach(
-    ([exampleName, description]) => cli2.example(exampleName, description)
+    ([exampleName, description]) => cli2.example(exampleName, descriptionStyle(description))
   );
   Object.entries(groups2).forEach(
-    ([groupName, optionNames]) => cli2.group(optionNames, groupName)
+    ([groupName, optionNames]) => cli2.group(optionNames, headerStyle(groupName))
   );
   middlewares2.forEach(({ middlewareFunction, applyBeforeValidation }) => {
     cli2.middleware(
@@ -3736,13 +4023,18 @@ function yargsCli(argv, cfg) {
     );
   });
   commands2.forEach((commandObj) => {
-    cli2.command({
-      ...commandObj,
-      handler: logErrorBeforeThrow(commandObj.handler),
-      ...typeof commandObj.builder === "function" && {
-        builder: logErrorBeforeThrow(commandObj.builder)
-      }
-    });
+    cli2.command(
+      formatObjectValue(
+        {
+          ...commandObj,
+          handler: logErrorBeforeThrow(commandObj.handler),
+          ...typeof commandObj.builder === "function" && {
+            builder: logErrorBeforeThrow(commandObj.builder)
+          }
+        },
+        "describe"
+      )
+    );
   });
   if (noExitProcess) {
     cli2.exitProcess(false);
@@ -3788,8 +4080,8 @@ var cli = (args) => yargsCli(args, {
       "Run collect skiping the coverage plugin, other plugins from config file will be included."
     ],
     [
-      "code-pushup upload --persist.outputDir=dist --persist.filename=cp-report --upload.apiKey=$CP_API_KEY",
-      "Upload dist/cp-report.json to portal using API key from environment variable"
+      "code-pushup upload --persist.outputDir=dist --upload.apiKey=$CP_API_KEY",
+      "Upload dist/report.json to portal using API key from environment variable"
     ],
     [
       "code-pushup print-config --config code-pushup.config.test.js",