@eslint-config-snapshot/cli 1.3.1 → 1.3.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @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

package/dist/index.cjs

@@ -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":
@@ -854,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) => {
@@ -885,7 +922,7 @@ async function executeCatalogUpdate(cwd, terminal, snapshotDir) {
   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, false));
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
   return 0;
 }
 async function executeCatalogCheck(cwd, terminal, snapshotDir) {
@@ -901,11 +938,11 @@ async function executeCatalogCheck(cwd, terminal, snapshotDir) {
   if (diffs.length === 0) {
     terminal.write("Great news: no catalog drift detected.\n");
     terminal.section("\u{1F4CA} Catalog summary");
-    terminal.write(formatShortCatalog(rows, false));
+    terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
     return 0;
   }
   terminal.section("\u{1F4CA} Catalog summary");
-  terminal.write(formatShortCatalog(rows, false));
+  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) {
@@ -950,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;
@@ -970,6 +1010,7 @@ async function computeCatalogRows(cwd, terminal, snapshotDir, commandLabel, prin
       coreRules,
       pluginRulesByPrefix,
       observedRules,
+      observedRuleLevels,
       missingRules,
       observedOffRules,
       observedActiveRules,
@@ -1775,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)
@@ -1901,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

@@ -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":
@@ -833,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) => {
@@ -864,7 +901,7 @@ async function executeCatalogUpdate(cwd, terminal, snapshotDir) {
   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, false));
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
   return 0;
 }
 async function executeCatalogCheck(cwd, terminal, snapshotDir) {
@@ -880,11 +917,11 @@ async function executeCatalogCheck(cwd, terminal, snapshotDir) {
   if (diffs.length === 0) {
     terminal.write("Great news: no catalog drift detected.\n");
     terminal.section("\u{1F4CA} Catalog summary");
-    terminal.write(formatShortCatalog(rows, false));
+    terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }));
     return 0;
   }
   terminal.section("\u{1F4CA} Catalog summary");
-  terminal.write(formatShortCatalog(rows, false));
+  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) {
@@ -929,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;
@@ -949,6 +989,7 @@ async function computeCatalogRows(cwd, terminal, snapshotDir, commandLabel, prin
       coreRules,
       pluginRulesByPrefix,
       observedRules,
+      observedRuleLevels,
       missingRules,
       observedOffRules,
       observedActiveRules,
@@ -1754,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)
@@ -1880,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.1",
+  "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.1"
+    "@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
   }
 
@@ -91,7 +93,7 @@ export async function executeCatalogUpdate(cwd: string, terminal: TerminalIO, sn
   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, false))
+  terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }))
   return 0
 }
 
@@ -110,12 +112,12 @@ export async function executeCatalogCheck(cwd: string, terminal: TerminalIO, sna
   if (diffs.length === 0) {
     terminal.write('Great news: no catalog drift detected.\n')
     terminal.section('📊 Catalog summary')
-    terminal.write(formatShortCatalog(rows, false))
+    terminal.write(formatShortCatalog(rows, { missingOnly: false, detailed: false, color: terminal.colors }))
     return 0
   }
 
   terminal.section('📊 Catalog summary')
-  terminal.write(formatShortCatalog(rows, false))
+  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(
@@ -169,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
@@ -194,6 +199,7 @@ async function computeCatalogRows(
         coreRules,
         pluginRulesByPrefix,
         observedRules,
+        observedRuleLevels,
         missingRules,
         observedOffRules,
         observedActiveRules,

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
@@ -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':

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('')
   })