Display alert in weekly report when there are >20 linter warnings (#58403)

Author: sarahs

src/content-linter/scripts/lint-report.ts

@@ -10,6 +10,9 @@ import { getAllRuleNames } from '@/content-linter/lib/helpers/rule-utils'
 // GitHub issue body size limit is ~65k characters, so we'll use 60k as a safe limit
 const MAX_ISSUE_BODY_SIZE = 60000
 
+// If the number of warnings exceeds this number, print a warning so we can give them attention
+const MAX_WARNINGS_BEFORE_ALERT = 20
+
 /**
  * Config that only applies to automated weekly reports.
  */
@@ -89,18 +92,27 @@ async function main() {
 
   const parsedResults = JSON.parse(lintResults)
 
+  // Keep track of warnings so we can print an alert when they exceed a manageable number
+  let totalWarnings = 0
+
   // Filter results based on reporting configuration
   const filteredResults: Record<string, LintFlaw[]> = {}
   for (const [file, flaws] of Object.entries(parsedResults)) {
     const filteredFlaws = (flaws as LintFlaw[]).filter((flaw) => shouldIncludeInReport(flaw))
 
     // Only include files that have remaining flaws after filtering
     if (filteredFlaws.length > 0) {
+      totalWarnings += filteredFlaws.filter((flaw) => flaw.severity === 'warning').length
       filteredResults[file] = filteredFlaws
     }
   }
   const totalFiles = Object.keys(filteredResults).length
-  let reportBody = 'The following files have markdown lint issues that require attention:\n\n'
+
+  const showTooManyWarningsAlert = totalWarnings > MAX_WARNINGS_BEFORE_ALERT
+  const tooManyWarningsAlertText = showTooManyWarningsAlert
+    ? `**Alert**: ${totalWarnings} warning-level issues have been found. These must be addressed ASAP so they do not continue to accumulate.\n\n`
+    : ''
+  let reportBody = `${tooManyWarningsAlertText}The following files have markdown lint issues that require attention:\n\n`
   let filesIncluded = 0
   let truncated = false