feat: enhance accessibility scan report with issue count and pagination details (#45)

Author: ruturaj-browserstack

src/tools/accessibility.ts

@@ -48,14 +48,19 @@ async function runAccessibilityScan(
   // Fetch CSV report link
   const reportLink = await reportFetcher.getReportLink(scanId, scanRunId);
 
-  const { records } = await parseAccessibilityReportFromCSV(reportLink);
+  const { records, page_length, total_issues } =
+    await parseAccessibilityReportFromCSV(reportLink);
 
   return {
     content: [
       {
         type: "text",
         text: `✅ Accessibility scan "${name}" completed. check the BrowserStack dashboard for more details [https://scanner.browserstack.com/site-scanner/scan-details/${name}].`,
       },
+      {
+        type: "text",
+        text: `We found ${total_issues} issues. Below are the details of the ${page_length} most critical issues.`,
+      },
       {
         type: "text",
         text: `Scan results: ${JSON.stringify(records, null, 2)}`,

src/tools/accessiblity-utils/report-parser.ts

@@ -20,6 +20,8 @@ type PaginationOptions = {
 type PaginatedResult = {
   records: SimplifiedAccessibilityIssue[];
   /** Character offset for the next page, or null if done */
+  page_length: number;
+  total_issues: number;
   next_page: number | null;
 };
 
@@ -43,6 +45,8 @@ export async function parseAccessibilityReportFromCSV(
     severity: (row["Severity"] || "unknown").trim(),
   }));
 
+  const totalIssues = all.length;
+
   // 2) Sort by severity
   const order: Record<string, number> = {
     critical: 0,
@@ -70,9 +74,13 @@ export async function parseAccessibilityReportFromCSV(
     charCursor += recStr.length;
   }
 
-  const hasMore = idx + page.length < all.length;
+  const pageLength = page.length;
+
+  const hasMore = idx + pageLength < totalIssues;
   return {
     records: page,
     next_page: hasMore ? charCursor : null,
+    page_length: pageLength,
+    total_issues: totalIssues,
   };
 }