@code-pushup/cli 0.50.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,18 +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: z15.string().optional().describe("Label (e.g. project name)"),
+  label: z16.string().optional().describe("Label (e.g. project name)"),
   categories: makeArraysComparisonSchema(
     categoryDiffSchema,
     categoryResultSchema,
@@ -857,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({
@@ -867,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);
 }
@@ -1595,6 +1606,29 @@ 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;
@@ -1632,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";
@@ -1833,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;
   }
@@ -1858,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);
     }
@@ -2152,15 +2221,6 @@ function createDiffCategoriesSection(diff, options2) {
 function createCategoriesTable(diff, options2) {
   const { changed, unchanged, added } = diff.categories;
   const { hasChanges, skipUnchanged } = options2;
-  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 rows = [
     ...sortChanges(changed).map((category) => [
       formatTitle(category),
@@ -2183,6 +2243,18 @@ function createCategoriesTable(diff, options2) {
       "\u2013"
     ])
   ];
+  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))
@@ -2463,7 +2535,7 @@ var verboseUtils = (verbose = false) => ({
 
 // packages/core/package.json
 var name = "@code-pushup/core";
-var version = "0.50.0";
+var version = "0.51.0";
 
 // packages/core/src/lib/implementation/execute-plugin.ts
 import { bold as bold5 } from "ansis";
@@ -2672,7 +2744,7 @@ async function persistReport(report, options2) {
       case "md":
         return {
           format: "md",
-          content: generateMdReport(sortedScoredReport)
+          content: generateMdReport(sortedScoredReport, { outputDir })
         };
     }
   });
@@ -3428,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 {
@@ -3441,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 {
@@ -3692,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
@@ -3706,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) {
@@ -3721,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
   };
 }
 
@@ -3796,11 +3847,7 @@ var middlewares = [
     applyBeforeValidation: false
   },
   {
-    middlewareFunction: onlyPluginsMiddleware,
-    applyBeforeValidation: false
-  },
-  {
-    middlewareFunction: skipPluginsMiddleware,
+    middlewareFunction: filterPluginsMiddleware,
     applyBeforeValidation: false
   }
 ];
@@ -3895,7 +3942,7 @@ import { blue, dim as dim2, green as green4 } from "ansis";
 import yargs from "yargs";
 
 // packages/cli/package.json
-var version2 = "0.50.0";
+var version2 = "0.51.0";
 
 // packages/cli/src/lib/implementation/formatting.ts
 import { bold as bold13, dim, green as green3 } from "ansis";

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@code-pushup/cli",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "license": "MIT",
   "description": "A CLI to run all kinds of code quality measurements to align your team with company goals",
   "bin": {
     "code-pushup": "index.js"
   },
   "dependencies": {
-    "@code-pushup/models": "0.50.0",
-    "@code-pushup/core": "0.50.0",
-    "@code-pushup/utils": "0.50.0",
+    "@code-pushup/models": "0.51.0",
+    "@code-pushup/core": "0.51.0",
+    "@code-pushup/utils": "0.51.0",
     "yargs": "^17.7.2",
     "ansis": "^3.3.0",
     "simple-git": "^3.20.0"

package/src/lib/implementation/filter-plugins.middleware.d.ts

@@ -0,0 +1,3 @@
+import type { OnlyPluginsOptions } from './only-plugins.model';
+import type { SkipPluginsOptions } from './skip-plugins.model';
+export declare function filterPluginsMiddleware<T extends SkipPluginsOptions & OnlyPluginsOptions>(originalProcessArgs: T): T;

package/src/lib/implementation/only-plugins.middleware.d.ts

@@ -1,2 +0,0 @@
-import type { OnlyPluginsOptions } from './only-plugins.model';
-export declare function onlyPluginsMiddleware<T extends OnlyPluginsOptions>(originalProcessArgs: T): T;

package/src/lib/implementation/skip-plugins.middleware.d.ts

@@ -1,2 +0,0 @@
-import type { SkipPluginsOptions } from './skip-plugins.model';
-export declare function skipPluginsMiddleware<T extends SkipPluginsOptions>(originalProcessArgs: T): T;