@eslint-config-snapshot/cli 1.3.0 → 1.3.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @eslint-config-snapshot/cli
 
+## 1.3.2
+
+### Patch Changes
+
+- Refine catalog output defaults with optional detailed grouped rule states and semantic colorized labels.
+- Updated dependencies
+  - @eslint-config-snapshot/api@1.3.2
+
+## 1.3.1
+
+### Patch Changes
+
+- Improve catalog check/update summaries and dedupe baseline totals across groups.
+- Updated dependencies
+  - @eslint-config-snapshot/api@1.3.1
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -102,7 +102,7 @@ function summarizeChanges(changes) {
   return { introduced, removed, severity, options, workspace };
 }
 function summarizeSnapshots(snapshots) {
-  const { rules, error, warn, off } = countRuleSeverities([...snapshots.values()].map((snapshot) => snapshot.rules));
+  const { rules, error, warn, off } = countUniqueRuleSeverities([...snapshots.values()].map((snapshot) => snapshot.rules));
   return { groups: snapshots.size, rules, error, warn, off };
 }
 function countUniqueWorkspaces(snapshots) {
@@ -185,7 +185,8 @@ function formatShortConfig(payload) {
   return `${lines.join("\n")}
 `;
 }
-function formatShortCatalog(catalogs, missingOnly) {
+function formatShortCatalog(catalogs, options) {
+  const { missingOnly, detailed, color } = options;
   const lines = [];
   const sorted = [...catalogs].sort((a, b) => a.groupId.localeCompare(b.groupId));
   const showGroupHeader = sorted.length > 1 || sorted.some((catalog) => catalog.groupId !== "default");
@@ -201,10 +202,8 @@ function formatShortCatalog(catalogs, missingOnly) {
     for (const plugin of catalog.pluginStats) {
       lines.push(`  - ${plugin.pluginId}: ${formatUsageLine(plugin)}`);
     }
-    const detailRules = missingOnly ? catalog.missingRules : catalog.availableRules;
-    lines.push(`${missingOnly ? "\u{1F573}\uFE0F missing list" : "\u{1F4DA} available list"} (${detailRules.length}):`);
-    for (const ruleName of detailRules) {
-      lines.push(`  - ${ruleName}`);
+    if (detailed) {
+      appendRuleStateGroups(lines, catalog, missingOnly, color);
     }
     if (showGroupHeader) {
       lines.push("");
@@ -219,6 +218,44 @@ function formatShortCatalog(catalogs, missingOnly) {
 function formatUsageLine(stats) {
   return `${stats.inUse}/${stats.totalAvailable} in use (${stats.inUsePct}%) | error ${stats.error} | warn ${stats.warn} | off ${stats.off} | not used ${stats.missing}`;
 }
+function appendRuleStateGroups(lines, catalog, missingOnly, color) {
+  if (missingOnly) {
+    appendRuleList(lines, color?.yellow("\u{1F7E1} unused") ?? "\u{1F7E1} unused", catalog.missingRules);
+    return;
+  }
+  const observedRuleSet = new Set(catalog.observedRules);
+  const errorRules = [];
+  const warnRules = [];
+  const offRules = [];
+  const unusedRules = [];
+  for (const ruleName of catalog.availableRules) {
+    if (!observedRuleSet.has(ruleName)) {
+      unusedRules.push(ruleName);
+      continue;
+    }
+    const level = catalog.observedRuleLevels[ruleName];
+    if (level === "off") {
+      offRules.push(ruleName);
+      continue;
+    }
+    if (level === "error") {
+      errorRules.push(ruleName);
+      continue;
+    }
+    warnRules.push(ruleName);
+  }
+  appendRuleList(lines, color?.green("\u{1F7E2} error") ?? "\u{1F7E2} error", errorRules);
+  appendRuleList(lines, color?.green("\u{1F7E2} warn") ?? "\u{1F7E2} warn", warnRules);
+  appendRuleList(lines, color?.cyan("\u{1F535} off") ?? "\u{1F535} off", offRules);
+  appendRuleList(lines, color?.yellow("\u{1F7E1} unused") ?? "\u{1F7E1} unused", unusedRules);
+}
+function appendRuleList(lines, label, rules) {
+  lines.push(`${label} (${rules.length}):`);
+  const sortedRules = [...rules].sort((a, b) => a.localeCompare(b));
+  for (const ruleName of sortedRules) {
+    lines.push(`  - ${ruleName}`);
+  }
+}
 function formatCommandDisplayLabel(commandLabel) {
   switch (commandLabel) {
     case "check":
@@ -276,25 +313,34 @@ function formatBaselineSummaryLines(summary, workspaceCount) {
 - \u{1F39A}\uFE0F severity mix: ${summary.error} errors, ${summary.warn} warnings, ${summary.off} off
 `;
 }
-function countRuleSeverities(ruleObjects) {
-  let rules = 0;
+function countUniqueRuleSeverities(ruleObjects) {
+  const severityRank = { off: 0, warn: 1, error: 2 };
+  const severityByRule = /* @__PURE__ */ new Map();
+  for (const rulesObject of ruleObjects) {
+    for (const [ruleName, entry] of Object.entries(rulesObject)) {
+      const nextSeverity = getPrimarySeverity(entry);
+      if (!nextSeverity) {
+        continue;
+      }
+      const currentSeverity = severityByRule.get(ruleName);
+      if (!currentSeverity || severityRank[nextSeverity] > severityRank[currentSeverity]) {
+        severityByRule.set(ruleName, nextSeverity);
+      }
+    }
+  }
   let error = 0;
   let warn = 0;
   let off = 0;
-  for (const rulesObject of ruleObjects) {
-    for (const entry of Object.values(rulesObject)) {
-      rules += 1;
-      const severity = getPrimarySeverity(entry);
-      if (severity === "error") {
-        error += 1;
-      } else if (severity === "warn") {
-        warn += 1;
-      } else {
-        off += 1;
-      }
+  for (const severity of severityByRule.values()) {
+    if (severity === "error") {
+      error += 1;
+    } else if (severity === "warn") {
+      warn += 1;
+    } else {
+      off += 1;
     }
   }
-  return { rules, error, warn, off };
+  return { rules: severityByRule.size, error, warn, off };
 }
 function getPrimarySeverity(entry) {
   if (!entry) {
@@ -845,10 +891,10 @@ function isDefaultEquivalentConfig(config) {
 
 // src/commands/catalog.ts
 var CATALOG_FILE_SUFFIX = ".catalog.json";
-async function executeCatalog(cwd, terminal, snapshotDir, format, missingOnly) {
+async function executeCatalog(cwd, terminal, snapshotDir, format, missingOnly, detailed) {
   const rows = await computeCatalogRows(cwd, terminal, snapshotDir, `catalog:${format}`, true);
   if (format === "short") {
-    terminal.write(formatShortCatalog(rows, missingOnly));
+    terminal.write(formatShortCatalog(rows, { missingOnly, detailed, color: terminal.colors }));
     return 0;
   }
   const output = rows.map((row) => {
@@ -871,10 +917,12 @@ async function executeCatalogUpdate(cwd, terminal, snapshotDir) {
   const rows = await computeCatalogRows(cwd, terminal, snapshotDir, "catalog:update", false);
   await writeCatalogBaselineFiles(cwd, snapshotDir, rows);
   const groups = rows.length;
-  const available = rows.reduce((sum, row) => sum + row.totalStats.totalAvailable, 0);
-  const inUse = rows.reduce((sum, row) => sum + row.totalStats.inUse, 0);
+  const available = countUniqueRules(rows.map((row) => row.availableRules));
+  const inUse = countUniqueRules(rows.map((row) => row.observedRules.filter((ruleName) => row.availableRules.includes(ruleName))));
   terminal.write(`\u{1F9EA} Catalog baseline updated: ${groups} groups, ${available} available rules, ${inUse} currently in use.
 `);
+  terminal.section("\u{1F4CA} Catalog summary");
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
   return 0;
 }
 async function executeCatalogCheck(cwd, terminal, snapshotDir) {
@@ -889,8 +937,12 @@ async function executeCatalogCheck(cwd, terminal, snapshotDir) {
   const diffs = compareCatalogBaselines(stored, current);
   if (diffs.length === 0) {
     terminal.write("Great news: no catalog drift detected.\n");
+    terminal.section("\u{1F4CA} Catalog summary");
+    terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
     return 0;
   }
+  terminal.section("\u{1F4CA} Catalog summary");
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
   terminal.write(`\u26A0\uFE0F Heads up: catalog drift detected in ${diffs.length} groups.
 `);
   for (const diff of diffs) {
@@ -935,6 +987,9 @@ async function computeCatalogRows(cwd, terminal, snapshotDir, commandLabel, prin
     const availableRules = catalog?.allRules ?? [];
     const availableRuleSet = new Set(availableRules);
     const missingRules = availableRules.filter((ruleName) => !snapshot.rules[ruleName]);
+    const observedRuleLevels = Object.fromEntries(
+      observedRules.map((ruleName) => [ruleName, getPrimarySeverity2(snapshot.rules[ruleName])])
+    );
     const observedOffRules = observedRules.filter((ruleName) => isRuleOffOnly(snapshot.rules[ruleName]));
     const observedActiveRules = observedRules.filter((ruleName) => !isRuleOffOnly(snapshot.rules[ruleName]));
     const observedOutsideCatalog = observedRules.filter((ruleName) => !availableRuleSet.has(ruleName)).length;
@@ -955,6 +1010,7 @@ async function computeCatalogRows(cwd, terminal, snapshotDir, commandLabel, prin
       coreRules,
       pluginRulesByPrefix,
       observedRules,
+      observedRuleLevels,
       missingRules,
       observedOffRules,
       observedActiveRules,
@@ -1131,6 +1187,15 @@ function toPercent(value, total) {
   }
   return Number((value / total * 100).toFixed(1));
 }
+function countUniqueRules(ruleLists) {
+  const unique = /* @__PURE__ */ new Set();
+  for (const rules of ruleLists) {
+    for (const rule of rules) {
+      unique.add(rule);
+    }
+  }
+  return unique.size;
+}
 
 // src/commands/check.ts
 var UPDATE_HINT = "Tip: when you intentionally accept changes, run `eslint-config-snapshot --update` to refresh the baseline.\n";
@@ -1751,6 +1816,7 @@ function createColorizer() {
   return {
     green: (text) => wrap("32", text),
     yellow: (text) => wrap("33", text),
+    cyan: (text) => wrap("36", text),
     red: (text) => wrap("31", text),
     bold: (text) => wrap("1", text),
     dim: (text) => wrap("2", text)
@@ -1877,9 +1943,9 @@ function createProgram(cwd, terminal, onActionExit) {
     const format = opts.short ? "short" : opts.format;
     onActionExit(await executePrint(cwd, terminal, SNAPSHOT_DIR, format));
   });
-  program.command("catalog").description("Print discovered rule catalog and missing rules").option("--format <format>", "Output format: json|short", parsePrintFormat, "json").option("--short", "Alias for --format short").option("--missing", "Only print rules that are available but not observed in current snapshots").action(async (opts) => {
+  program.command("catalog").description("Print discovered rule catalog and missing rules").option("--format <format>", "Output format: json|short", parsePrintFormat, "json").option("--short", "Alias for --format short").option("--detailed", "Show detailed rule lists grouped by error, warn, off, and unused").option("--missing", "Only print rules that are available but not observed in current snapshots").action(async (opts) => {
     const format = opts.short ? "short" : opts.format;
-    onActionExit(await executeCatalog(cwd, terminal, SNAPSHOT_DIR, format, Boolean(opts.missing)));
+    onActionExit(await executeCatalog(cwd, terminal, SNAPSHOT_DIR, format, Boolean(opts.missing), Boolean(opts.detailed)));
   });
   program.command("catalog-check").description("Compare current catalog against stored catalog baseline").action(async () => {
     onActionExit(await executeCatalogCheck(cwd, terminal, SNAPSHOT_DIR));

package/dist/index.js

@@ -67,7 +67,7 @@ function summarizeChanges(changes) {
   return { introduced, removed, severity, options, workspace };
 }
 function summarizeSnapshots(snapshots) {
-  const { rules, error, warn, off } = countRuleSeverities([...snapshots.values()].map((snapshot) => snapshot.rules));
+  const { rules, error, warn, off } = countUniqueRuleSeverities([...snapshots.values()].map((snapshot) => snapshot.rules));
   return { groups: snapshots.size, rules, error, warn, off };
 }
 function countUniqueWorkspaces(snapshots) {
@@ -150,7 +150,8 @@ function formatShortConfig(payload) {
   return `${lines.join("\n")}
 `;
 }
-function formatShortCatalog(catalogs, missingOnly) {
+function formatShortCatalog(catalogs, options) {
+  const { missingOnly, detailed, color } = options;
   const lines = [];
   const sorted = [...catalogs].sort((a, b) => a.groupId.localeCompare(b.groupId));
   const showGroupHeader = sorted.length > 1 || sorted.some((catalog) => catalog.groupId !== "default");
@@ -166,10 +167,8 @@ function formatShortCatalog(catalogs, missingOnly) {
     for (const plugin of catalog.pluginStats) {
       lines.push(`  - ${plugin.pluginId}: ${formatUsageLine(plugin)}`);
     }
-    const detailRules = missingOnly ? catalog.missingRules : catalog.availableRules;
-    lines.push(`${missingOnly ? "\u{1F573}\uFE0F missing list" : "\u{1F4DA} available list"} (${detailRules.length}):`);
-    for (const ruleName of detailRules) {
-      lines.push(`  - ${ruleName}`);
+    if (detailed) {
+      appendRuleStateGroups(lines, catalog, missingOnly, color);
     }
     if (showGroupHeader) {
       lines.push("");
@@ -184,6 +183,44 @@ function formatShortCatalog(catalogs, missingOnly) {
 function formatUsageLine(stats) {
   return `${stats.inUse}/${stats.totalAvailable} in use (${stats.inUsePct}%) | error ${stats.error} | warn ${stats.warn} | off ${stats.off} | not used ${stats.missing}`;
 }
+function appendRuleStateGroups(lines, catalog, missingOnly, color) {
+  if (missingOnly) {
+    appendRuleList(lines, color?.yellow("\u{1F7E1} unused") ?? "\u{1F7E1} unused", catalog.missingRules);
+    return;
+  }
+  const observedRuleSet = new Set(catalog.observedRules);
+  const errorRules = [];
+  const warnRules = [];
+  const offRules = [];
+  const unusedRules = [];
+  for (const ruleName of catalog.availableRules) {
+    if (!observedRuleSet.has(ruleName)) {
+      unusedRules.push(ruleName);
+      continue;
+    }
+    const level = catalog.observedRuleLevels[ruleName];
+    if (level === "off") {
+      offRules.push(ruleName);
+      continue;
+    }
+    if (level === "error") {
+      errorRules.push(ruleName);
+      continue;
+    }
+    warnRules.push(ruleName);
+  }
+  appendRuleList(lines, color?.green("\u{1F7E2} error") ?? "\u{1F7E2} error", errorRules);
+  appendRuleList(lines, color?.green("\u{1F7E2} warn") ?? "\u{1F7E2} warn", warnRules);
+  appendRuleList(lines, color?.cyan("\u{1F535} off") ?? "\u{1F535} off", offRules);
+  appendRuleList(lines, color?.yellow("\u{1F7E1} unused") ?? "\u{1F7E1} unused", unusedRules);
+}
+function appendRuleList(lines, label, rules) {
+  lines.push(`${label} (${rules.length}):`);
+  const sortedRules = [...rules].sort((a, b) => a.localeCompare(b));
+  for (const ruleName of sortedRules) {
+    lines.push(`  - ${ruleName}`);
+  }
+}
 function formatCommandDisplayLabel(commandLabel) {
   switch (commandLabel) {
     case "check":
@@ -241,25 +278,34 @@ function formatBaselineSummaryLines(summary, workspaceCount) {
 - \u{1F39A}\uFE0F severity mix: ${summary.error} errors, ${summary.warn} warnings, ${summary.off} off
 `;
 }
-function countRuleSeverities(ruleObjects) {
-  let rules = 0;
+function countUniqueRuleSeverities(ruleObjects) {
+  const severityRank = { off: 0, warn: 1, error: 2 };
+  const severityByRule = /* @__PURE__ */ new Map();
+  for (const rulesObject of ruleObjects) {
+    for (const [ruleName, entry] of Object.entries(rulesObject)) {
+      const nextSeverity = getPrimarySeverity(entry);
+      if (!nextSeverity) {
+        continue;
+      }
+      const currentSeverity = severityByRule.get(ruleName);
+      if (!currentSeverity || severityRank[nextSeverity] > severityRank[currentSeverity]) {
+        severityByRule.set(ruleName, nextSeverity);
+      }
+    }
+  }
   let error = 0;
   let warn = 0;
   let off = 0;
-  for (const rulesObject of ruleObjects) {
-    for (const entry of Object.values(rulesObject)) {
-      rules += 1;
-      const severity = getPrimarySeverity(entry);
-      if (severity === "error") {
-        error += 1;
-      } else if (severity === "warn") {
-        warn += 1;
-      } else {
-        off += 1;
-      }
+  for (const severity of severityByRule.values()) {
+    if (severity === "error") {
+      error += 1;
+    } else if (severity === "warn") {
+      warn += 1;
+    } else {
+      off += 1;
     }
   }
-  return { rules, error, warn, off };
+  return { rules: severityByRule.size, error, warn, off };
 }
 function getPrimarySeverity(entry) {
   if (!entry) {
@@ -824,10 +870,10 @@ function isDefaultEquivalentConfig(config) {
 
 // src/commands/catalog.ts
 var CATALOG_FILE_SUFFIX = ".catalog.json";
-async function executeCatalog(cwd, terminal, snapshotDir, format, missingOnly) {
+async function executeCatalog(cwd, terminal, snapshotDir, format, missingOnly, detailed) {
   const rows = await computeCatalogRows(cwd, terminal, snapshotDir, `catalog:${format}`, true);
   if (format === "short") {
-    terminal.write(formatShortCatalog(rows, missingOnly));
+    terminal.write(formatShortCatalog(rows, { missingOnly, detailed, color: terminal.colors }));
     return 0;
   }
   const output = rows.map((row) => {
@@ -850,10 +896,12 @@ async function executeCatalogUpdate(cwd, terminal, snapshotDir) {
   const rows = await computeCatalogRows(cwd, terminal, snapshotDir, "catalog:update", false);
   await writeCatalogBaselineFiles(cwd, snapshotDir, rows);
   const groups = rows.length;
-  const available = rows.reduce((sum, row) => sum + row.totalStats.totalAvailable, 0);
-  const inUse = rows.reduce((sum, row) => sum + row.totalStats.inUse, 0);
+  const available = countUniqueRules(rows.map((row) => row.availableRules));
+  const inUse = countUniqueRules(rows.map((row) => row.observedRules.filter((ruleName) => row.availableRules.includes(ruleName))));
   terminal.write(`\u{1F9EA} Catalog baseline updated: ${groups} groups, ${available} available rules, ${inUse} currently in use.
 `);
+  terminal.section("\u{1F4CA} Catalog summary");
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
   return 0;
 }
 async function executeCatalogCheck(cwd, terminal, snapshotDir) {
@@ -868,8 +916,12 @@ async function executeCatalogCheck(cwd, terminal, snapshotDir) {
   const diffs = compareCatalogBaselines(stored, current);
   if (diffs.length === 0) {
     terminal.write("Great news: no catalog drift detected.\n");
+    terminal.section("\u{1F4CA} Catalog summary");
+    terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
     return 0;
   }
+  terminal.section("\u{1F4CA} Catalog summary");
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
   terminal.write(`\u26A0\uFE0F Heads up: catalog drift detected in ${diffs.length} groups.
 `);
   for (const diff of diffs) {
@@ -914,6 +966,9 @@ async function computeCatalogRows(cwd, terminal, snapshotDir, commandLabel, prin
     const availableRules = catalog?.allRules ?? [];
     const availableRuleSet = new Set(availableRules);
     const missingRules = availableRules.filter((ruleName) => !snapshot.rules[ruleName]);
+    const observedRuleLevels = Object.fromEntries(
+      observedRules.map((ruleName) => [ruleName, getPrimarySeverity2(snapshot.rules[ruleName])])
+    );
     const observedOffRules = observedRules.filter((ruleName) => isRuleOffOnly(snapshot.rules[ruleName]));
     const observedActiveRules = observedRules.filter((ruleName) => !isRuleOffOnly(snapshot.rules[ruleName]));
     const observedOutsideCatalog = observedRules.filter((ruleName) => !availableRuleSet.has(ruleName)).length;
@@ -934,6 +989,7 @@ async function computeCatalogRows(cwd, terminal, snapshotDir, commandLabel, prin
       coreRules,
       pluginRulesByPrefix,
       observedRules,
+      observedRuleLevels,
       missingRules,
       observedOffRules,
       observedActiveRules,
@@ -1110,6 +1166,15 @@ function toPercent(value, total) {
   }
   return Number((value / total * 100).toFixed(1));
 }
+function countUniqueRules(ruleLists) {
+  const unique = /* @__PURE__ */ new Set();
+  for (const rules of ruleLists) {
+    for (const rule of rules) {
+      unique.add(rule);
+    }
+  }
+  return unique.size;
+}
 
 // src/commands/check.ts
 var UPDATE_HINT = "Tip: when you intentionally accept changes, run `eslint-config-snapshot --update` to refresh the baseline.\n";
@@ -1730,6 +1795,7 @@ function createColorizer() {
   return {
     green: (text) => wrap("32", text),
     yellow: (text) => wrap("33", text),
+    cyan: (text) => wrap("36", text),
     red: (text) => wrap("31", text),
     bold: (text) => wrap("1", text),
     dim: (text) => wrap("2", text)
@@ -1856,9 +1922,9 @@ function createProgram(cwd, terminal, onActionExit) {
     const format = opts.short ? "short" : opts.format;
     onActionExit(await executePrint(cwd, terminal, SNAPSHOT_DIR, format));
   });
-  program.command("catalog").description("Print discovered rule catalog and missing rules").option("--format <format>", "Output format: json|short", parsePrintFormat, "json").option("--short", "Alias for --format short").option("--missing", "Only print rules that are available but not observed in current snapshots").action(async (opts) => {
+  program.command("catalog").description("Print discovered rule catalog and missing rules").option("--format <format>", "Output format: json|short", parsePrintFormat, "json").option("--short", "Alias for --format short").option("--detailed", "Show detailed rule lists grouped by error, warn, off, and unused").option("--missing", "Only print rules that are available but not observed in current snapshots").action(async (opts) => {
     const format = opts.short ? "short" : opts.format;
-    onActionExit(await executeCatalog(cwd, terminal, SNAPSHOT_DIR, format, Boolean(opts.missing)));
+    onActionExit(await executeCatalog(cwd, terminal, SNAPSHOT_DIR, format, Boolean(opts.missing), Boolean(opts.detailed)));
   });
   program.command("catalog-check").description("Compare current catalog against stored catalog baseline").action(async () => {
     onActionExit(await executeCatalogCheck(cwd, terminal, SNAPSHOT_DIR));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-config-snapshot/cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "type": "module",
   "repository": {
     "type": "git",
@@ -31,6 +31,6 @@
     "commander": "^14.0.3",
     "debug": "^4.4.3",
     "fast-glob": "^3.3.3",
-    "@eslint-config-snapshot/api": "1.3.0"
+    "@eslint-config-snapshot/api": "1.3.2"
   }
 }

package/src/commands/catalog.ts

@@ -18,6 +18,7 @@ type CatalogRow = {
   coreRules: string[]
   pluginRulesByPrefix: Record<string, string[]>
   observedRules: string[]
+  observedRuleLevels: Record<string, 'error' | 'warn' | 'off'>
   missingRules: string[]
   observedOffRules: string[]
   observedActiveRules: string[]
@@ -55,12 +56,13 @@ export async function executeCatalog(
   terminal: TerminalIO,
   snapshotDir: string,
   format: CatalogFormat,
-  missingOnly: boolean
+  missingOnly: boolean,
+  detailed: boolean
 ): Promise<number> {
   const rows = await computeCatalogRows(cwd, terminal, snapshotDir, `catalog:${format}`, true)
 
   if (format === 'short') {
-    terminal.write(formatShortCatalog(rows, missingOnly))
+    terminal.write(formatShortCatalog(rows, { missingOnly, detailed, color: terminal.colors }))
     return 0
   }
 
@@ -87,9 +89,11 @@ export async function executeCatalogUpdate(cwd: string, terminal: TerminalIO, sn
   await writeCatalogBaselineFiles(cwd, snapshotDir, rows)
 
   const groups = rows.length
-  const available = rows.reduce((sum, row) => sum + row.totalStats.totalAvailable, 0)
-  const inUse = rows.reduce((sum, row) => sum + row.totalStats.inUse, 0)
+  const available = countUniqueRules(rows.map((row) => row.availableRules))
+  const inUse = countUniqueRules(rows.map((row) => row.observedRules.filter((ruleName) => row.availableRules.includes(ruleName))))
   terminal.write(`🧪 Catalog baseline updated: ${groups} groups, ${available} available rules, ${inUse} currently in use.\n`)
+  terminal.section('📊 Catalog summary')
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }))
   return 0
 }
 
@@ -107,9 +111,13 @@ export async function executeCatalogCheck(cwd: string, terminal: TerminalIO, sna
   const diffs = compareCatalogBaselines(stored, current)
   if (diffs.length === 0) {
     terminal.write('Great news: no catalog drift detected.\n')
+    terminal.section('📊 Catalog summary')
+    terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }))
     return 0
   }
 
+  terminal.section('📊 Catalog summary')
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }))
   terminal.write(`⚠️ Heads up: catalog drift detected in ${diffs.length} groups.\n`)
   for (const diff of diffs) {
     terminal.write(
@@ -163,6 +171,9 @@ async function computeCatalogRows(
       const availableRules = catalog?.allRules ?? []
       const availableRuleSet = new Set(availableRules)
       const missingRules = availableRules.filter((ruleName) => !snapshot.rules[ruleName])
+      const observedRuleLevels = Object.fromEntries(
+        observedRules.map((ruleName) => [ruleName, getPrimarySeverity(snapshot.rules[ruleName])])
+      ) as Record<string, 'error' | 'warn' | 'off'>
       const observedOffRules = observedRules.filter((ruleName) => isRuleOffOnly(snapshot.rules[ruleName]))
       const observedActiveRules = observedRules.filter((ruleName) => !isRuleOffOnly(snapshot.rules[ruleName]))
       const observedOutsideCatalog = observedRules.filter((ruleName) => !availableRuleSet.has(ruleName)).length
@@ -188,6 +199,7 @@ async function computeCatalogRows(
         coreRules,
         pluginRulesByPrefix,
         observedRules,
+        observedRuleLevels,
         missingRules,
         observedOffRules,
         observedActiveRules,
@@ -392,3 +404,13 @@ function toPercent(value: number, total: number): number {
   }
   return Number(((value / total) * 100).toFixed(1))
 }
+
+function countUniqueRules(ruleLists: string[][]): number {
+  const unique = new Set<string>()
+  for (const rules of ruleLists) {
+    for (const rule of rules) {
+      unique.add(rule)
+    }
+  }
+  return unique.size
+}

package/src/formatters.ts

@@ -14,6 +14,7 @@ export type RuleCatalogLike = {
   coreRules: string[]
   pluginRulesByPrefix: Record<string, string[]>
   observedRules: string[]
+  observedRuleLevels: Record<string, 'error' | 'warn' | 'off'>
   missingRules: string[]
   observedOffRules: string[]
   observedActiveRules: string[]
@@ -21,6 +22,11 @@ export type RuleCatalogLike = {
   coreStats: UsageStats
   pluginStats: Array<{ pluginId: string } & UsageStats>
 }
+type CatalogColorizer = {
+  green: (text: string) => string
+  yellow: (text: string) => string
+  cyan: (text: string) => string
+}
 
 export type UsageStats = {
   totalAvailable: number
@@ -101,7 +107,7 @@ export function summarizeChanges(changes: Array<{ groupId: string; diff: Snapsho
 }
 
 export function summarizeSnapshots(snapshots: Map<string, SnapshotLike>) {
-  const { rules, error, warn, off } = countRuleSeverities([...snapshots.values()].map((snapshot) => snapshot.rules))
+  const { rules, error, warn, off } = countUniqueRuleSeverities([...snapshots.values()].map((snapshot) => snapshot.rules))
   return { groups: snapshots.size, rules, error, warn, off }
 }
 
@@ -211,7 +217,11 @@ export function formatShortConfig(payload: {
   return `${lines.join('\n')}\n`
 }
 
-export function formatShortCatalog(catalogs: RuleCatalogLike[], missingOnly: boolean): string {
+export function formatShortCatalog(
+  catalogs: RuleCatalogLike[],
+  options: { missingOnly: boolean; detailed: boolean; color?: CatalogColorizer }
+): string {
+  const { missingOnly, detailed, color } = options
   const lines: string[] = []
   const sorted = [...catalogs].sort((a, b) => a.groupId.localeCompare(b.groupId))
   const showGroupHeader = sorted.length > 1 || sorted.some((catalog) => catalog.groupId !== 'default')
@@ -228,10 +238,8 @@ export function formatShortCatalog(catalogs: RuleCatalogLike[], missingOnly: boo
       lines.push(`  - ${plugin.pluginId}: ${formatUsageLine(plugin)}`)
     }
 
-    const detailRules = missingOnly ? catalog.missingRules : catalog.availableRules
-    lines.push(`${missingOnly ? '🕳️ missing list' : '📚 available list'} (${detailRules.length}):`)
-    for (const ruleName of detailRules) {
-      lines.push(`  - ${ruleName}`)
+    if (detailed) {
+      appendRuleStateGroups(lines, catalog, missingOnly, color)
     }
     if (showGroupHeader) {
       lines.push('')
@@ -247,6 +255,54 @@ function formatUsageLine(stats: UsageStats): string {
   return `${stats.inUse}/${stats.totalAvailable} in use (${stats.inUsePct}%) | error ${stats.error} | warn ${stats.warn} | off ${stats.off} | not used ${stats.missing}`
 }
 
+function appendRuleStateGroups(
+  lines: string[],
+  catalog: RuleCatalogLike,
+  missingOnly: boolean,
+  color?: CatalogColorizer
+): void {
+  if (missingOnly) {
+    appendRuleList(lines, color?.yellow('🟡 unused') ?? '🟡 unused', catalog.missingRules)
+    return
+  }
+
+  const observedRuleSet = new Set(catalog.observedRules)
+  const errorRules: string[] = []
+  const warnRules: string[] = []
+  const offRules: string[] = []
+  const unusedRules: string[] = []
+
+  for (const ruleName of catalog.availableRules) {
+    if (!observedRuleSet.has(ruleName)) {
+      unusedRules.push(ruleName)
+      continue
+    }
+    const level = catalog.observedRuleLevels[ruleName]
+    if (level === 'off') {
+      offRules.push(ruleName)
+      continue
+    }
+    if (level === 'error') {
+      errorRules.push(ruleName)
+      continue
+    }
+    warnRules.push(ruleName)
+  }
+
+  appendRuleList(lines, color?.green('🟢 error') ?? '🟢 error', errorRules)
+  appendRuleList(lines, color?.green('🟢 warn') ?? '🟢 warn', warnRules)
+  appendRuleList(lines, color?.cyan('🔵 off') ?? '🔵 off', offRules)
+  appendRuleList(lines, color?.yellow('🟡 unused') ?? '🟡 unused', unusedRules)
+}
+
+function appendRuleList(lines: string[], label: string, rules: string[]): void {
+  lines.push(`${label} (${rules.length}):`)
+  const sortedRules = [...rules].sort((a, b) => a.localeCompare(b))
+  for (const ruleName of sortedRules) {
+    lines.push(`  - ${ruleName}`)
+  }
+}
+
 export function formatCommandDisplayLabel(commandLabel: string): string {
   switch (commandLabel) {
     case 'check':
@@ -331,6 +387,39 @@ export function countRuleSeverities(ruleObjects: RuleObject[]) {
   return { rules, error, warn, off }
 }
 
+export function countUniqueRuleSeverities(ruleObjects: RuleObject[]) {
+  const severityRank: Record<'off' | 'warn' | 'error', number> = { off: 0, warn: 1, error: 2 }
+  const severityByRule = new Map<string, 'off' | 'warn' | 'error'>()
+
+  for (const rulesObject of ruleObjects) {
+    for (const [ruleName, entry] of Object.entries(rulesObject)) {
+      const nextSeverity = getPrimarySeverity(entry)
+      if (!nextSeverity) {
+        continue
+      }
+      const currentSeverity = severityByRule.get(ruleName)
+      if (!currentSeverity || severityRank[nextSeverity] > severityRank[currentSeverity]) {
+        severityByRule.set(ruleName, nextSeverity)
+      }
+    }
+  }
+
+  let error = 0
+  let warn = 0
+  let off = 0
+  for (const severity of severityByRule.values()) {
+    if (severity === 'error') {
+      error += 1
+    } else if (severity === 'warn') {
+      warn += 1
+    } else {
+      off += 1
+    }
+  }
+
+  return { rules: severityByRule.size, error, warn, off }
+}
+
 function getPrimarySeverity(entry: SnapshotRuleEntry | undefined): 'off' | 'warn' | 'error' | undefined {
   if (!entry) {
     return undefined

package/src/index.ts

@@ -181,10 +181,11 @@ function createProgram(cwd: string, terminal: TerminalIO, onActionExit: (code: n
     .description('Print discovered rule catalog and missing rules')
     .option('--format <format>', 'Output format: json|short', parsePrintFormat, 'json')
     .option('--short', 'Alias for --format short')
+    .option('--detailed', 'Show detailed rule lists grouped by error, warn, off, and unused')
     .option('--missing', 'Only print rules that are available but not observed in current snapshots')
-    .action(async (opts: { format: CatalogFormat; short?: boolean; missing?: boolean }) => {
+    .action(async (opts: { format: CatalogFormat; short?: boolean; missing?: boolean; detailed?: boolean }) => {
       const format: CatalogFormat = opts.short ? 'short' : opts.format
-      onActionExit(await executeCatalog(cwd, terminal, SNAPSHOT_DIR, format, Boolean(opts.missing)))
+      onActionExit(await executeCatalog(cwd, terminal, SNAPSHOT_DIR, format, Boolean(opts.missing), Boolean(opts.detailed)))
     })
 
   program

package/src/terminal.ts

@@ -3,6 +3,7 @@ import { createInterface } from 'node:readline'
 type Colorizer = {
   green: (text: string) => string
   yellow: (text: string) => string
+  cyan: (text: string) => string
   red: (text: string) => string
   bold: (text: string) => string
   dim: (text: string) => string
@@ -171,6 +172,7 @@ function createColorizer(): Colorizer {
   return {
     green: (text: string) => wrap('32', text),
     yellow: (text: string) => wrap('33', text),
+    cyan: (text: string) => wrap('36', text),
     red: (text: string) => wrap('31', text),
     bold: (text: string) => wrap('1', text),
     dim: (text: string) => wrap('2', text)

package/test/cli.integration.test.ts

@@ -238,10 +238,19 @@ no-debugger: off
     expect(output).toContain('🧱 core: 2/3 in use')
     expect(output).toContain('🔌 plugins tracked: 1')
     expect(output).toContain('  - alpha: 0/2 in use')
-    expect(output).toContain('🕳️ missing list (3):')
-    expect(output).toContain('alpha/observed')
+    expect(output).not.toContain('🟡 unused')
+  })
+
+  it('catalog --short --detailed prints grouped detailed lists', async () => {
+    const writeSpy = vi.spyOn(process.stdout, 'write')
+    const code = await runCli('catalog', fixtureRoot, ['--short', '--detailed'])
+    expect(code).toBe(0)
+    const output = String(writeSpy.mock.calls.at(-1)?.[0] ?? '')
+    expect(output).toContain('🟢 error')
+    expect(output).toContain('🟢 warn')
+    expect(output).toContain('🔵 off')
+    expect(output).toContain('🟡 unused')
     expect(output).toContain('alpha/only-in-catalog')
-    expect(output).toContain('no-alert')
   })
 
   it('init creates scaffold config file when target=file', async () => {

package/test/cli.terminal.integration.test.ts

@@ -255,10 +255,18 @@ no-debugger: off
     expect(result.stdout).toContain('🧱 core: 2/3 in use')
     expect(result.stdout).toContain('🔌 plugins tracked: 1')
     expect(result.stdout).toContain('  - alpha: 0/2 in use')
-    expect(result.stdout).toContain('🕳️ missing list (3):')
-    expect(result.stdout).toContain('alpha/observed')
+    expect(result.stdout).not.toContain('🟡 unused')
+    expect(result.stderr).toBe('')
+  })
+
+  it('catalog --short --detailed returns grouped state lists', () => {
+    const result = run(['catalog', '--short', '--detailed'])
+    expect(result.status).toBe(0)
+    expect(result.stdout).toContain('🟢 error')
+    expect(result.stdout).toContain('🟢 warn')
+    expect(result.stdout).toContain('🔵 off')
+    expect(result.stdout).toContain('🟡 unused')
     expect(result.stdout).toContain('alpha/only-in-catalog')
-    expect(result.stdout).toContain('no-alert')
     expect(result.stderr).toBe('')
   })
 
@@ -266,11 +274,15 @@ no-debugger: off
     const update = run(['catalog-update'])
     expect(update.status).toBe(0)
     expect(update.stdout).toContain('Catalog baseline updated:')
+    expect(update.stdout).toContain('📦 total:')
+    expect(update.stdout).toContain('🔌 plugins tracked:')
     expect(update.stderr).toBe('')
 
     const check = run(['catalog-check'])
     expect(check.status).toBe(0)
-    expect(check.stdout).toBe('Great news: no catalog drift detected.\n')
+    expect(check.stdout).toContain('Great news: no catalog drift detected.')
+    expect(check.stdout).toContain('📦 total:')
+    expect(check.stdout).toContain('🔌 plugins tracked:')
     expect(check.stderr).toBe('')
   })
 

package/test/formatters.unit.test.ts

@@ -44,4 +44,35 @@ describe('output helpers', () => {
     )
     expect(summary).toEqual({ groups: 1, rules: 3, error: 1, warn: 1, off: 1 })
   })
+
+  it('deduplicates rules across groups in summary', () => {
+    const summary = summarizeSnapshots(
+      new Map([
+        [
+          'group-a',
+          {
+            groupId: 'group-a',
+            workspaces: ['packages/a'],
+            rules: {
+              shared: ['warn'],
+              onlyA: ['off']
+            }
+          }
+        ],
+        [
+          'group-b',
+          {
+            groupId: 'group-b',
+            workspaces: ['packages/b'],
+            rules: {
+              shared: ['error'],
+              onlyB: ['warn']
+            }
+          }
+        ]
+      ])
+    )
+
+    expect(summary).toEqual({ groups: 2, rules: 3, error: 1, warn: 1, off: 1 })
+  })
 })