feat: add watcher warning to module report

Author: KristjanESPERANTO

scripts/check-modules/__tests__/result-markdown.test.js

@@ -20,6 +20,12 @@ describe("result-markdown", () => {
         name: "MMM-Boolean",
         maintainer: "Carol",
         issues: true
+      },
+      {
+        name: "MMM-Quiet",
+        maintainer: "Dana",
+        url: "https://github.com/example/MMM-Quiet",
+        watchersCount: 0
       }
     ]);
 
@@ -29,6 +35,12 @@ describe("result-markdown", () => {
         maintainer: "Alice",
         url: "https://github.com/example/MMM-Example",
         issues: ["Issue one", "Issue two"]
+      },
+      {
+        name: "MMM-Quiet",
+        maintainer: "Dana",
+        url: "https://github.com/example/MMM-Quiet",
+        issues: ["GitHub reports 0 watchers; maintainer notifications may be missed."]
       }
     ]);
   });

scripts/check-modules/result-markdown.ts

@@ -18,6 +18,7 @@ interface ProcessedModuleLike {
   issues?: boolean | string[] | string | null;
   maintainer?: string;
   name?: string;
+  watchersCount?: number;
   url?: string;
 }
 
@@ -41,13 +42,18 @@ export function collectIssueSummaries(modules: unknown[]): IssueSummary[] {
 
     const stageModule = module as ProcessedModuleLike;
     const issues = normalizeIssuesInput(stageModule.issues);
+    const watcherIssue = stageModule.watchersCount === 0
+      ? "GitHub reports 0 watchers; maintainer notifications may be missed."
+      : null;
 
-    if (issues.length === 0 || typeof stageModule.name !== "string" || typeof stageModule.maintainer !== "string") {
+    const combinedIssues = watcherIssue ? [...issues, watcherIssue] : issues;
+
+    if (combinedIssues.length === 0 || typeof stageModule.name !== "string" || typeof stageModule.maintainer !== "string") {
       return [];
     }
 
     return [{
-      issues,
+      issues: combinedIssues,
       maintainer: stageModule.maintainer,
       name: stageModule.name,
       url: typeof stageModule.url === "string" ? stageModule.url : undefined
@@ -67,6 +73,7 @@ export function buildResultMarkdown(stats: ResultMarkdownStats, summaries: Issue
     "* Some issues are opinionated recommendations. Please feel free to ignore them.",
     ""
   );
+
   lines.push("## Statistics", "");
   lines.push("|                      | number   |");
   lines.push("|:---------------------|:--------:|");

scripts/shared/module-catalogue-output.ts

@@ -17,6 +17,7 @@ export interface ProcessedModule extends ModuleRecord {
   maintainer?: string;
   name?: string;
   outdated?: boolean;
+  watchersCount?: number;
   stars?: number;
   tags?: string[];
   url?: string;
@@ -107,6 +108,7 @@ const PROCESSED_MODULE_ALLOWED_KEYS: string[] = [
   "outdated",
   "issues",
   "stars",
+  "watchersCount",
   "license",
   "hasGithubIssues",
   "isArchived",

scripts/updateRepositoryApiData/__tests__/api.test.js

@@ -0,0 +1,31 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+
+import { normalizeRepositoryData } from "../api.ts";
+
+describe("updateRepositoryApiData/api", () => {
+  it("exposes GitHub subscriber count as watchersCount", () => {
+    const normalized = normalizeRepositoryData({
+      stargazers_count: 12,
+      subscribers_count: 0,
+      has_issues: true,
+      archived: false,
+      defaultBranchRef: { target: { committedDate: "2026-01-01T00:00:00.000Z" } }
+    }, null, "github");
+
+    assert.strictEqual(normalized.watchersCount, 0);
+    assert.strictEqual(normalized.stars, 12);
+  });
+
+  it("keeps a non-zero GitHub subscriber count intact", () => {
+    const normalized = normalizeRepositoryData({
+      stargazers_count: 12,
+      subscribers_count: 7,
+      has_issues: true,
+      archived: false,
+      defaultBranchRef: { target: { committedDate: "2026-01-01T00:00:00.000Z" } }
+    }, null, "github");
+
+    assert.strictEqual(normalized.watchersCount, 7);
+  });
+});

scripts/updateRepositoryApiData/api.ts

@@ -41,6 +41,7 @@ interface RepositoryApiData {
   stargazerCount?: number;
   stargazers_count?: number;
   stars_count?: number;
+  subscribers_count?: number;
   watchers_count?: number;
   [key: string]: unknown;
 }
@@ -68,6 +69,7 @@ export interface NormalizedRepositoryMetadata {
   isArchived: boolean;
   lastCommit: string | null;
   license: string | null;
+  watchersCount?: number;
   stars: number;
 }
 
@@ -171,13 +173,15 @@ export function normalizeRepositoryData(data: RepositoryApiData, branchData: Rep
   let license: string | null = null;
   let hasGithubIssues = false;
   let lastCommit: string | null = null;
+  let watchersCount: number | undefined;
 
   switch (repoType) {
     case "github":
       stars = data.stargazers_count ?? data.stargazerCount ?? 0;
       license = data.license?.spdx_id ?? data.licenseInfo?.spdxId ?? null;
       hasGithubIssues = data.has_issues ?? data.hasIssuesEnabled ?? false;
       lastCommit = branchData?.commit?.author?.date ?? data.defaultBranchRef?.target?.committedDate ?? data.pushedAt ?? null;
+      watchersCount = data.subscribers_count ?? 0;
       break;
     case "gitlab":
       stars = data.star_count ?? 0;
@@ -205,6 +209,7 @@ export function normalizeRepositoryData(data: RepositoryApiData, branchData: Rep
     license,
     hasGithubIssues,
     isArchived,
-    lastCommit
+    lastCommit,
+    watchersCount
   };
 }