roast-my-design-system 3.6.0 → 3.7.1

package/README.md

@@ -7,7 +7,7 @@
 Run this skill on your codebase and get, in about a second:
 
 - **A health score you can defend in a meeting.** 0-100, deterministic, benchmarked against Ideal Design System norms, 30 scanned public repos and 10 reputable design systems (Primer, Polaris, Carbon, shadcn/ui…).
-- **The receipts behind it.** Every colour, spacing value, typeface, duplicated component and inline style, with real file paths, in one self-contained HTML report you can open, Slack or email.
+- **The receipts behind it.** Every colour and its near-identical twin, every spacing value, typeface, duplicated or never-imported component, inline style and !important, with real file paths, in one self-contained HTML report you can open, Slack or email.
 - **The first fixes ranked by payoff.** A "Where to start" list derived from your own numbers: keep the report as the audit, or hand it to Claude as the punch list for the fix.
 - **Rules that stop the mess coming back.** A generated `design-system-rules.md` for your CLAUDE.md or .cursor/rules: canonical components, your token file, known duplicates to avoid, so your AI agent follows your system instead of guessing at it.
 
@@ -24,11 +24,11 @@ Your AI agent (Claude, Cursor, Copilot) builds UI by imitating what's already in
 
 The full report for vercel/ai-chatbot, top to bottom:
 
-![The full diagnosis report for vercel/ai-chatbot in dark mode: health score, three-yardstick tiles, palette forensics, spacing receipts, typography, offenders, duplicates, and the where-to-start close](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-full-dark.png?v=3.6.0)
+![The full diagnosis report for vercel/ai-chatbot in dark mode: health score, three-yardstick tiles, palette forensics, spacing receipts, typography, offenders, duplicates, and the where-to-start close](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-full-dark.png?v=3.7.1)
 
 The same report in light mode (one file, built-in toggle):
 
-![The diagnosis report in light mode](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-light-hero.png?v=3.6.0)
+![The diagnosis report in light mode](https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/report-light-hero.png?v=3.7.1)
 
 ## What makes the numbers trustworthy
 
@@ -120,11 +120,16 @@ Three real roasts of public repos, hosted as-is (the same self-contained HTML th
 | Duplicated components | 0 | 14 | 10 |
 | Inline style blocks | 0 | 42 | 12 |
 | Arbitrary Tailwind values | ~20 | 91 | 0 |
+| Near-identical colour pairs | 0 | 2 | 1 |
+| !important declarations | 0 | 5 | 3 |
+| Components never imported | 0 | 0 | 0 |
 
 Yes, the median repo is already a mess. That's the point.
 
 ## License
 
-MIT
+MIT. The code is yours to fork, modify and redistribute; the copyright notice travels with it.
 
-Built and designed by <a href="https://gregkozakiewicz.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark-dark.png?v=3.6.0"><img src="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark.png?v=3.6.0" height="15" alt="GK mark"></picture> Greg Kozakiewicz</a>.
+**roast-my-design-system**™ and the GK mark are trademarks of Greg Kozakiewicz. Forking is welcome, republishing under this name is not: see [brand and attribution](https://pencilrebel.github.io/roast-my-design-system/brand.html).
+
+Built and designed by <a href="https://gregkozakiewicz.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark-dark.png?v=3.7.1"><img src="https://raw.githubusercontent.com/pencilrebel/roast-my-design-system/main/assets/gk-mark.png?v=3.7.1" height="15" alt="GK mark"></picture> Greg Kozakiewicz</a>.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "roast-my-design-system",
-  "version": "3.6.0",
-  "description": "Roast your design system with real data. A deterministic, zero-dependency scanner that counts every colour, grey, spacing value, typeface, duplicated component, inline style and arbitrary Tailwind value in your repo, scores it 0-100 against Ideal Design System norms and a 30-repo benchmark, generates a shareable HTML diagnosis, and with --rules writes the agent rules file (CLAUDE.md, .cursor/rules) that stops the mess coming back.",
+  "version": "3.7.1",
+  "description": "Roast your design system with real data. A deterministic, zero-dependency scanner that counts everything that betrays a design system, from colours and their near-identical twins to greys, spacing values, typefaces, duplicated and never-imported components, inline styles, !important and arbitrary Tailwind values, scores it 0-100 against Ideal Design System norms and a 30-repo benchmark, generates a shareable HTML diagnosis, and with --rules writes the agent rules file (CLAUDE.md, .cursor/rules) that stops the mess coming back.",
   "keywords": [
     "design-system",
     "design-tokens",

package/skills/roast-my-design-system/scripts/benchmark/benchmark.json

@@ -1,5 +1,5 @@
 {
-  "builtAt": "2026-08-01T17:38:24.498Z",
+  "builtAt": "2026-08-03T16:33:32.652Z",
   "repoCount": 30,
   "ideal2026": {
     "colors": {
@@ -38,6 +38,18 @@
       "value": 0,
       "note": "styling belongs to the system"
     },
+    "nearPairs": {
+      "value": 0,
+      "note": "near-identical colours are copy-paste, not decisions"
+    },
+    "important": {
+      "value": 0,
+      "note": "!important is the cascade admitting defeat"
+    },
+    "neverImported": {
+      "value": 0,
+      "note": "a system component nobody imports is dead weight"
+    },
     "arbitrary": {
       "value": 20,
       "note": "bracket escape hatches; a handful of deliberate exceptions"
@@ -104,7 +116,7 @@
         174,
         206,
         246,
-        302,
+        303,
         385,
         403,
         1645
@@ -112,7 +124,7 @@
       "p25": 38,
       "median": 96,
       "p75": 170,
-      "p90": 310
+      "p90": 311
     },
     "greys": {
       "values": [
@@ -373,7 +385,7 @@
         95,
         103,
         115,
-        187
+        189
       ],
       "p25": 1,
       "median": 14,
@@ -397,7 +409,7 @@
         23,
         37,
         41,
-        42,
+        43,
         46,
         47,
         51,
@@ -411,7 +423,7 @@
         122,
         173,
         1178,
-        2914
+        2923
       ],
       "p25": 8,
       "median": 42,
@@ -443,7 +455,7 @@
         234,
         271,
         321,
-        374,
+        380,
         407,
         468,
         470,
@@ -456,6 +468,120 @@
       "p75": 309,
       "p90": 472
     },
+    "nearPairs": {
+      "values": [
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        1,
+        1,
+        2,
+        2,
+        2,
+        9,
+        12,
+        13,
+        13,
+        15,
+        16,
+        23,
+        26,
+        30,
+        37,
+        47,
+        49,
+        70,
+        146
+      ],
+      "p25": 0,
+      "median": 2,
+      "p75": 21,
+      "p90": 47
+    },
+    "important": {
+      "values": [
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        1,
+        1,
+        2,
+        4,
+        5,
+        5,
+        6,
+        9,
+        9,
+        11,
+        12,
+        20,
+        35,
+        42,
+        42,
+        74,
+        83,
+        88,
+        161
+      ],
+      "p25": 0,
+      "median": 5,
+      "p75": 18,
+      "p90": 75
+    },
+    "neverImported": {
+      "values": [
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        5,
+        7,
+        10,
+        13,
+        22,
+        22,
+        26,
+        36,
+        39,
+        45,
+        94,
+        100
+      ],
+      "p25": 0,
+      "median": 0,
+      "p75": 20,
+      "p90": 40
+    },
     "components": {
       "values": [
         9,
@@ -471,27 +597,27 @@
         342,
         350,
         417,
-        546,
-        629,
+        555,
+        637,
         777,
-        790,
-        834,
+        796,
+        836,
         936,
         940,
-        961,
+        962,
         970,
-        1043,
+        1052,
         1081,
         1216,
         1379,
         1414,
         1619,
-        2133,
-        2549
+        2134,
+        2566
       ],
       "p25": 233,
-      "median": 703,
-      "p75": 1025,
+      "median": 707,
+      "p75": 1032,
       "p90": 1435
     }
   },
@@ -511,6 +637,9 @@
         "exactDuplicates": 115,
         "inlineStyles": 79,
         "arbitrary": 321,
+        "nearPairs": 47,
+        "important": 161,
+        "neverImported": 39,
         "components": 1414
       }
     },
@@ -529,6 +658,9 @@
         "exactDuplicates": 3,
         "inlineStyles": 82,
         "arbitrary": 0,
+        "nearPairs": 49,
+        "important": 88,
+        "neverImported": 0,
         "components": 342
       }
     },
@@ -547,13 +679,16 @@
         "exactDuplicates": 4,
         "inlineStyles": 23,
         "arbitrary": 0,
+        "nearPairs": 37,
+        "important": 4,
+        "neverImported": 0,
         "components": 50
       }
     },
     {
       "repo": "outline/outline",
       "designSystem": "custom",
-      "codeFiles": 2100,
+      "codeFiles": 2122,
       "metrics": {
         "colors": 89,
         "greys": 15,
@@ -565,7 +700,10 @@
         "exactDuplicates": 23,
         "inlineStyles": 76,
         "arbitrary": 0,
-        "components": 629
+        "nearPairs": 1,
+        "important": 0,
+        "neverImported": 0,
+        "components": 637
       }
     },
     {
@@ -583,6 +721,9 @@
         "exactDuplicates": 2,
         "inlineStyles": 0,
         "arbitrary": 4,
+        "nearPairs": 0,
+        "important": 5,
+        "neverImported": 0,
         "components": 220
       }
     },
@@ -601,6 +742,9 @@
         "exactDuplicates": 0,
         "inlineStyles": 0,
         "arbitrary": 0,
+        "nearPairs": 0,
+        "important": 0,
+        "neverImported": 0,
         "components": 25
       }
     },
@@ -619,6 +763,9 @@
         "exactDuplicates": 0,
         "inlineStyles": 0,
         "arbitrary": 60,
+        "nearPairs": 0,
+        "important": 1,
+        "neverImported": 94,
         "components": 182
       }
     },
@@ -637,6 +784,9 @@
         "exactDuplicates": 0,
         "inlineStyles": 0,
         "arbitrary": 0,
+        "nearPairs": 0,
+        "important": 0,
+        "neverImported": 0,
         "components": 9
       }
     },
@@ -655,6 +805,9 @@
         "exactDuplicates": 1,
         "inlineStyles": 2,
         "arbitrary": 16,
+        "nearPairs": 0,
+        "important": 2,
+        "neverImported": 0,
         "components": 60
       }
     },
@@ -673,6 +826,9 @@
         "exactDuplicates": 1,
         "inlineStyles": 7,
         "arbitrary": 103,
+        "nearPairs": 0,
+        "important": 9,
+        "neverImported": 0,
         "components": 315
       }
     },
@@ -691,13 +847,16 @@
         "exactDuplicates": 1,
         "inlineStyles": 11,
         "arbitrary": 148,
+        "nearPairs": 0,
+        "important": 0,
+        "neverImported": 100,
         "components": 272
       }
     },
     {
       "repo": "documenso/documenso",
       "designSystem": "custom",
-      "codeFiles": 1906,
+      "codeFiles": 1912,
       "metrics": {
         "colors": 36,
         "greys": 13,
@@ -709,13 +868,16 @@
         "exactDuplicates": 17,
         "inlineStyles": 69,
         "arbitrary": 234,
-        "components": 790
+        "nearPairs": 15,
+        "important": 0,
+        "neverImported": 45,
+        "components": 796
       }
     },
     {
       "repo": "dubinc/dub",
       "designSystem": "custom",
-      "codeFiles": 3523,
+      "codeFiles": 3526,
       "metrics": {
         "colors": 102,
         "greys": 14,
@@ -727,6 +889,9 @@
         "exactDuplicates": 17,
         "inlineStyles": 47,
         "arbitrary": 470,
+        "nearPairs": 13,
+        "important": 1,
+        "neverImported": 22,
         "components": 1379
       }
     },
@@ -745,6 +910,9 @@
         "exactDuplicates": 59,
         "inlineStyles": 18,
         "arbitrary": 164,
+        "nearPairs": 13,
+        "important": 83,
+        "neverImported": 0,
         "components": 940
       }
     },
@@ -763,13 +931,16 @@
         "exactDuplicates": 92,
         "inlineStyles": 119,
         "arbitrary": 164,
+        "nearPairs": 0,
+        "important": 0,
+        "neverImported": 5,
         "components": 1081
       }
     },
     {
       "repo": "lukevella/rallly",
       "designSystem": "custom",
-      "codeFiles": 689,
+      "codeFiles": 692,
       "metrics": {
         "colors": 26,
         "greys": 4,
@@ -781,7 +952,10 @@
         "exactDuplicates": 10,
         "inlineStyles": 23,
         "arbitrary": 27,
-        "components": 546
+        "nearPairs": 2,
+        "important": 0,
+        "neverImported": 22,
+        "components": 555
       }
     },
     {
@@ -799,13 +973,16 @@
         "exactDuplicates": 20,
         "inlineStyles": 46,
         "arbitrary": 407,
+        "nearPairs": 0,
+        "important": 42,
+        "neverImported": 13,
         "components": 777
       }
     },
     {
       "repo": "elie222/inbox-zero",
       "designSystem": "custom",
-      "codeFiles": 1808,
+      "codeFiles": 1821,
       "metrics": {
         "colors": 154,
         "greys": 24,
@@ -817,7 +994,10 @@
         "exactDuplicates": 21,
         "inlineStyles": 5,
         "arbitrary": 125,
-        "components": 834
+        "nearPairs": 26,
+        "important": 6,
+        "neverImported": 0,
+        "components": 836
       }
     },
     {
@@ -835,6 +1015,9 @@
         "exactDuplicates": 7,
         "inlineStyles": 41,
         "arbitrary": 78,
+        "nearPairs": 0,
+        "important": 0,
+        "neverImported": 0,
         "components": 190
       }
     },
@@ -853,13 +1036,16 @@
         "exactDuplicates": 0,
         "inlineStyles": 173,
         "arbitrary": 1,
+        "nearPairs": 2,
+        "important": 5,
+        "neverImported": 0,
         "components": 417
       }
     },
     {
       "repo": "twentyhq/twenty",
       "designSystem": "library",
-      "codeFiles": 15125,
+      "codeFiles": 15132,
       "metrics": {
         "colors": 1645,
         "greys": 100,
@@ -871,13 +1057,16 @@
         "exactDuplicates": 22,
         "inlineStyles": 122,
         "arbitrary": 0,
-        "components": 2133
+        "nearPairs": 146,
+        "important": 9,
+        "neverImported": 0,
+        "components": 2134
       }
     },
     {
       "repo": "langfuse/langfuse",
       "designSystem": "custom",
-      "codeFiles": 2758,
+      "codeFiles": 2774,
       "metrics": {
         "colors": 170,
         "greys": 4,
@@ -887,9 +1076,12 @@
         "radii": 10,
         "shadows": 0,
         "exactDuplicates": 7,
-        "inlineStyles": 42,
-        "arbitrary": 374,
-        "components": 1043
+        "inlineStyles": 43,
+        "arbitrary": 380,
+        "nearPairs": 2,
+        "important": 12,
+        "neverImported": 10,
+        "components": 1052
       }
     },
     {
@@ -907,6 +1099,9 @@
         "exactDuplicates": 45,
         "inlineStyles": 37,
         "arbitrary": 468,
+        "nearPairs": 70,
+        "important": 42,
+        "neverImported": 0,
         "components": 1216
       }
     },
@@ -925,6 +1120,9 @@
         "exactDuplicates": 95,
         "inlineStyles": 22,
         "arbitrary": 561,
+        "nearPairs": 16,
+        "important": 74,
+        "neverImported": 7,
         "components": 1619
       }
     },
@@ -943,31 +1141,37 @@
         "exactDuplicates": 19,
         "inlineStyles": 1178,
         "arbitrary": 0,
+        "nearPairs": 23,
+        "important": 35,
+        "neverImported": 36,
         "components": 350
       }
     },
     {
       "repo": "lobehub/lobe-chat",
       "designSystem": "library",
-      "codeFiles": 8299,
+      "codeFiles": 8344,
       "metrics": {
-        "colors": 302,
+        "colors": 303,
         "greys": 37,
         "spacing": 61,
         "typefaces": 1,
         "fontSizes": 2,
         "radii": 1,
         "shadows": 0,
-        "exactDuplicates": 187,
-        "inlineStyles": 2914,
+        "exactDuplicates": 189,
+        "inlineStyles": 2923,
         "arbitrary": 0,
-        "components": 2549
+        "nearPairs": 9,
+        "important": 0,
+        "neverImported": 0,
+        "components": 2566
       }
     },
     {
       "repo": "danny-avila/LibreChat",
       "designSystem": "custom",
-      "codeFiles": 2424,
+      "codeFiles": 2430,
       "metrics": {
         "colors": 174,
         "greys": 30,
@@ -979,7 +1183,10 @@
         "exactDuplicates": 38,
         "inlineStyles": 71,
         "arbitrary": 492,
-        "components": 961
+        "nearPairs": 30,
+        "important": 20,
+        "neverImported": 0,
+        "components": 962
       }
     },
     {
@@ -997,13 +1204,16 @@
         "exactDuplicates": 103,
         "inlineStyles": 117,
         "arbitrary": 1751,
+        "nearPairs": 12,
+        "important": 0,
+        "neverImported": 26,
         "components": 970
       }
     },
     {
       "repo": "triggerdotdev/trigger.dev",
       "designSystem": "custom",
-      "codeFiles": 2354,
+      "codeFiles": 2366,
       "metrics": {
         "colors": 137,
         "greys": 18,
@@ -1015,6 +1225,9 @@
         "exactDuplicates": 8,
         "inlineStyles": 51,
         "arbitrary": 271,
+        "nearPairs": 1,
+        "important": 11,
+        "neverImported": 0,
         "components": 936
       }
     },
@@ -1033,12 +1246,15 @@
         "exactDuplicates": 0,
         "inlineStyles": 0,
         "arbitrary": 26,
+        "nearPairs": 0,
+        "important": 0,
+        "neverImported": 0,
         "components": 36
       }
     }
   ],
   "referenceSystems": {
-    "builtAt": "2026-08-01T17:38:26.401Z",
+    "builtAt": "2026-08-03T16:33:34.617Z",
     "count": 10,
     "note": "Curated scoped scans of reputable public design systems. Not comparable head-to-head with product repos: see per-system notes.",
     "stats": {
@@ -1192,6 +1408,51 @@
         ],
         "median": 0
       },
+      "nearPairs": {
+        "values": [
+          0,
+          0,
+          0,
+          0,
+          1,
+          1,
+          1,
+          5,
+          33,
+          50
+        ],
+        "median": 1
+      },
+      "important": {
+        "values": [
+          0,
+          0,
+          0,
+          1,
+          1,
+          4,
+          4,
+          30,
+          33,
+          61
+        ],
+        "median": 3
+      },
+      "neverImported": {
+        "values": [
+          0,
+          0,
+          0,
+          0,
+          0,
+          0,
+          0,
+          0,
+          0,
+          0
+        ],
+        "median": 0
+      },
       "components": {
         "values": [
           0,
@@ -1226,6 +1487,9 @@
           "exactDuplicates": 0,
           "inlineStyles": 1,
           "arbitrary": 35,
+          "nearPairs": 0,
+          "important": 0,
+          "neverImported": 0,
           "components": 331
         }
       },
@@ -1246,6 +1510,9 @@
           "exactDuplicates": 13,
           "inlineStyles": 14,
           "arbitrary": 0,
+          "nearPairs": 5,
+          "important": 33,
+          "neverImported": 0,
           "components": 228
         }
       },
@@ -1266,6 +1533,9 @@
           "exactDuplicates": 15,
           "inlineStyles": 10,
           "arbitrary": 0,
+          "nearPairs": 0,
+          "important": 30,
+          "neverImported": 0,
           "components": 243
         }
       },
@@ -1286,6 +1556,9 @@
           "exactDuplicates": 6,
           "inlineStyles": 17,
           "arbitrary": 0,
+          "nearPairs": 1,
+          "important": 4,
+          "neverImported": 0,
           "components": 314
         }
       },
@@ -1306,6 +1579,9 @@
           "exactDuplicates": 2,
           "inlineStyles": 10,
           "arbitrary": 0,
+          "nearPairs": 50,
+          "important": 0,
+          "neverImported": 0,
           "components": 170
         }
       },
@@ -1326,6 +1602,9 @@
           "exactDuplicates": 0,
           "inlineStyles": 1,
           "arbitrary": 0,
+          "nearPairs": 1,
+          "important": 0,
+          "neverImported": 0,
           "components": 711
         }
       },
@@ -1346,6 +1625,9 @@
           "exactDuplicates": 17,
           "inlineStyles": 24,
           "arbitrary": 0,
+          "nearPairs": 1,
+          "important": 1,
+          "neverImported": 0,
           "components": 246
         }
       },
@@ -1366,6 +1648,9 @@
           "exactDuplicates": 0,
           "inlineStyles": 0,
           "arbitrary": 0,
+          "nearPairs": 33,
+          "important": 61,
+          "neverImported": 0,
           "components": 0
         }
       },
@@ -1386,6 +1671,9 @@
           "exactDuplicates": 170,
           "inlineStyles": 14,
           "arbitrary": 0,
+          "nearPairs": 0,
+          "important": 1,
+          "neverImported": 0,
           "components": 819
         }
       },
@@ -1406,6 +1694,9 @@
           "exactDuplicates": 28,
           "inlineStyles": 22,
           "arbitrary": 0,
+          "nearPairs": 0,
+          "important": 4,
+          "neverImported": 0,
           "components": 508
         }
       }

package/skills/roast-my-design-system/scripts/diagnose/index.mjs

@@ -13,6 +13,7 @@ import { fileURLToPath } from 'node:url';
 import { distinctTypefaces } from '../lib/typefaces.mjs';
 import { rulesMarkdown } from '../rules/build.mjs';
 import { nearColorPairs } from '../lib/nearpairs.mjs';
+import { neverImportedComponents } from '../lib/neverimported.mjs';
 
 // The benchmark (Ideal-2026 norms + scanned-repo stats) ships next to the
 // code so the page works offline; degrade gracefully when absent.
@@ -35,7 +36,35 @@ const GK_MASK = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqa
 const GK_MARK = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAIAAAD8GO2jAAAACXBIWXMAAAAAAAAAAQCEeRdzAAACPklEQVR4nOVWTYh5URR/PlJYEKV8LKwkZalsmI2dZmMnK8pKmaZ87JSanexEkayUhSxsZyfJNBQ7UYqVhSShfM+v/6mXmtU81+p/Frfze+/d3++ce88993Hcf2cikehZ1GazWafTPUVDLBZjLBQKnU6HMTVvcrl8Op3ebrdsNgsokUiYUVP4Pp/v9s96vd79cwZGK95sNkkgGAwC2u12lhrY3u12C/b1ei2TyV5eXjabjV6vZ6BBa51MJin8arUKWKlU4H99fSkUCo5JUQ2HQxJwuVzIYLVawcdIVSs8CQoNpMQ+Go0Aw+EwwXw+D+h2u4Vr0LRSqUSMqVQKsN1uE3Q4HEql8ng8BgIBTnDhqlSqxWIBuvP5bDAYLBbL5XIBHAwGeBuJRODvdjun0/nnPOjraDRK8TYaDcBMJkMwFosBfn9/E0wkEn9OgjYgnU6fTidQwAGcTCbw9/u9VqvFUYB/vV5RskajkRNcTiaTKR6PI9j5fE7xlstlPM/lcgTr9ToneJ/5oOB4PB70O8Tb7/f9fv9sNqPkXl9fhQsQ9f1ktVqNvUVCxA6ZRxsf5pMAxnsuVBSOwvv7+6Phk0PsBNn0OOLC9haLReqdvBL/wUNKNPnt7Q0LjeVutVqhUEij0TwU9W8BVA4JUEUul8tarcZGhpbIarWiSeA0HQ4Hkvn4+GB56VMvov6DA+z1eplR89btdsE+Ho9tNhv3jOv+8/MTFz06M3ypVMqMnTfcwPhn4djG/tue+Mf4RGom9gMt6lAx16huIwAAAABJRU5ErkJggg==';
 
 // Shown in the report footer; keep in step with plugin.json when releasing.
-const VERSION = '3.6.0';
+const VERSION = '3.7.1';
+
+// Report identity. The scan id is a stable digest of this scan's shape, salted
+// with the report namespace, so the same repo scanned twice reads the same and
+// two different repos never collide. Shown in the footer for support and for
+// telling two reports apart at a glance.
+const ID_NS = 'rmds.pencilrebel.2026';
+function digest(str) {
+  // FNV-1a, two rounds with different offsets — no dependencies, stable output
+  const round = (seed) => {
+    let hv = seed;
+    for (let i = 0; i < str.length; i++) {
+      hv ^= str.charCodeAt(i);
+      hv = Math.imul(hv, 0x01000193) >>> 0;
+    }
+    return hv.toString(16).padStart(8, '0');
+  };
+  return (round(0x811c9dc5) + round(0x2fa1c3d7)).slice(0, 12);
+}
+// Namespace tag carried in the document head: schema owner, version, build day.
+const NS_TAG = `${ID_NS.split('.')[1]}/${VERSION}`;
+// Namespace marker woven into the title as zero-width characters: present in
+// every rendered report, invisible on screen, untouched by copy-paste.
+const nsMark = [...ID_NS.split('.')[1]]
+  .map((ch) => ch.charCodeAt(0).toString(2).padStart(8, '0'))
+  .join('')
+  .replace(/0/g, '\u200b')
+  .replace(/1/g, '\u200c');
+
 
 // Two shipped skins, same layout: 'dark' (navy glass, mint accent) and
 // 'light' (lilac wash, white glass, violet accent). --theme picks one.
@@ -136,6 +165,7 @@ const reusable = comps.filter((c) => !c.isPage);
 const agentFiles = (h.context ?? []).filter((c) => c.kind === 'agent-rules');
 const repoName = h.profile?.name ?? basename(h.repo);
 const ds = h.profile?.designSystem ?? { kind: 'none' };
+const scanId = digest([ID_NS, repoName, h.files?.code ?? 0, (h.harvestedAt ?? '').slice(0, 10), colors.length].join('|'));
 
 const fontFamilies = h.tokens.fontFamilies ?? [];
 const typefaces = distinctTypefaces(fontFamilies);
@@ -157,16 +187,7 @@ const important = h.tokens.important ?? { count: 0, files: [] };
 
 const nearPairs = nearColorPairs(colors);
 
-// Components defined but never imported — scoped to the design-system
-// directory, where "nobody imports this" is meaningful. File-local
-// subcomponents elsewhere legitimately never get imported by name.
-const dsDirRe = h.profile?.uiDir
-  ? new RegExp(`^${h.profile.uiDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}/`)
-  : /(^|\/)(packages\/ui|design-system|ui-kit)\//;
-const usedFiles = new Set(reusable.filter((c) => c.usageCount > 0).map((c) => c.file));
-const neverImported = reusable.filter((c) => !c.usageCount && dsDirRe.test(c.file)
-  && !/(^|\/)icons?\//.test(c.file)          // glyph sets are deliberately complete
-  && !usedFiles.has(c.file));                 // compound API: an adopted file's sub-exports are surface, not dead
+const neverImported = neverImportedComponents(h.components, h.profile?.uiDir);
 
 // Benchmark helpers: for a metric value, where does this repo sit among the
 // scanned fleet? ("more colours than 90% of scanned repos")
@@ -254,8 +275,8 @@ if (bench && findings.length) {
 // Where the median is missing or sits at/below ideal, warn caps at 1.5x ideal.
 // Zero-ideal metrics (duplicates, inline styles): 0 is good; a small tolerance
 // is warn; beyond that bad.
-const ZERO_IDEAL = new Set(['exactDuplicates', 'inlineStyles']);
-const WARN_TOLERANCE = { exactDuplicates: 2, inlineStyles: 10 };
+const ZERO_IDEAL = new Set(['exactDuplicates', 'inlineStyles', 'nearPairs', 'important', 'neverImported']);
+const WARN_TOLERANCE = { exactDuplicates: 2, inlineStyles: 10, nearPairs: 2, important: 5, neverImported: 2 };
 // Absence rule also skipped for arbitrary values: zero brackets is discipline
 // (nine of ten reputable systems sit at 0, including Tailwind-native shadcn/ui).
 const NO_ABSENCE_RULE = new Set(['colors', 'greys', 'arbitrary']);
@@ -308,6 +329,9 @@ const bigStats = [
   tile(spacingTotal, 'off-scale spacing values', 'spacing', 'a dozen deliberate exceptions'),
   tile(hardDupes.length, 'duplicated components', 'exactDuplicates', 'should be 0'),
   tile(inline.count, 'inline style blocks', 'inlineStyles', 'invisible to any system'),
+  tile(nearPairs.length, 'near-identical colour pairs', 'nearPairs', 'copy-paste, not decisions'),
+  tile(important.count, '!important declarations', 'important', 'the cascade admitting defeat'),
+  tile(neverImported.length, 'components never imported', 'neverImported', 'the system nobody found'),
   tile(arbitraryCount, 'arbitrary bracket values', 'arbitrary', 'a handful of deliberate exceptions'),
 ];
 
@@ -644,7 +668,7 @@ const stack = [
 const html = `<!doctype html>
 <html lang="en" data-theme="${themeName}"><head><meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Design-system diagnosis: ${esc(repoName)}</title>
+<title>Design-system diagnosis:${nsMark} ${esc(repoName)}</title>
 <meta name="author" content="Greg Kozakiewicz · gregkozakiewicz.com">
 <link rel="icon" type="image/png" sizes="32x32" href="${GK_MARK}">
 <link rel="icon" type="image/png" sizes="192x192" href="data:image/png;base64,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">
@@ -857,6 +881,7 @@ const html = `<!doctype html>
     border-top:1px solid var(--line); margin-top:40px; padding-top:22px; color:var(--dim); font-size:11.5px; }
   .foot-left { display:grid; gap:5px; }
   .foot-sub { color:var(--dim2); }
+  .scan-id { font-family:var(--mono); font-size:11px; letter-spacing:.04em; }
   footer .brand { color:var(--accent); font-weight:700; text-decoration:none; }
   footer .brand:hover { text-decoration:underline; }
   footer .creds { display:flex; gap:16px; font:700 9.5px/1.6 var(--sans); letter-spacing:.16em; text-transform:uppercase; color:var(--dim2); }
@@ -901,7 +926,9 @@ const html = `<!doctype html>
   .gk-mark { display:inline-block; width:15px; height:15px; margin-right:5px; vertical-align:-3px;
     background:currentColor; -webkit-mask:url(${GK_MASK}) center/contain no-repeat; mask:url(${GK_MASK}) center/contain no-repeat; }
   .author:hover { text-decoration:underline; }
-</style></head><body>
+</style>
+<!-- rmds-schema: ${NS_TAG} -->
+</head><body>
 <button class="theme-toggle glass" aria-label="Switch between light and dark mode" onclick="(function(){var r=document.documentElement,t=r.getAttribute('data-theme')==='light'?'dark':'light';r.setAttribute('data-theme',t);try{localStorage.setItem('roast-theme',t)}catch(e){}})()">
   <svg class="only-dark" viewBox="0 0 24 24"><circle cx="12" cy="12" r="4"/><line x1="12" y1="2" x2="12" y2="5"/><line x1="12" y1="19" x2="12" y2="22"/><line x1="2" y1="12" x2="5" y2="12"/><line x1="19" y1="12" x2="22" y2="12"/><line x1="4.9" y1="4.9" x2="7" y2="7"/><line x1="17" y1="17" x2="19.1" y2="19.1"/><line x1="4.9" y1="19.1" x2="7" y2="17"/><line x1="17" y1="7" x2="19.1" y2="4.9"/></svg>
   <svg class="only-light" viewBox="0 0 24 24"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"/></svg>
@@ -949,7 +976,7 @@ ${componentsSection()}
 <footer>
   <div class="foot-left">
     <div>Generated by <a class="brand" href="https://github.com/pencilrebel/roast-my-design-system">roast-my-design-system</a>, a free skill for Claude Code and Codex</div>
-    <div class="foot-sub"><span class="ver">ver. ${VERSION}</span> · built and designed by <a class="author" href="https://gregkozakiewicz.com"><span class="gk-mark"></span>Greg Kozakiewicz</a></div>
+    <div class="foot-sub"><span class="ver">ver. ${VERSION}</span> · <span class="scan-id" title="scan id">${scanId}</span> · built and designed by <a class="author" href="https://gregkozakiewicz.com"><span class="gk-mark"></span>Greg Kozakiewicz</a></div>
   </div>
   <span class="creds"><span>Non-destructive scan</span><span>Read-only</span><span>Paths are real</span></span>
 </footer>

package/skills/roast-my-design-system/scripts/lib/neverimported.mjs

@@ -0,0 +1,17 @@
+/**
+ * Design-system components defined but never imported — scoped so the claim
+ * is honest. File-local subcomponents elsewhere legitimately never get
+ * imported by name; icon sets are deliberately complete; sub-exports of an
+ * adopted file are API surface, not dead code. Shared by diagnose, rules and
+ * the benchmark builder.
+ */
+export function neverImportedComponents(components, uiDir) {
+  const reusable = (components ?? []).filter((c) => !c.isPage);
+  const dsDirRe = uiDir
+    ? new RegExp(`^${uiDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}/`)
+    : /(^|\/)(packages\/ui|design-system|ui-kit)\//;
+  const usedFiles = new Set(reusable.filter((c) => c.usageCount > 0).map((c) => c.file));
+  return reusable.filter((c) => !c.usageCount && dsDirRe.test(c.file)
+    && !/(^|\/)icons?\//.test(c.file)
+    && !usedFiles.has(c.file));
+}

package/skills/roast-my-design-system/scripts/rules/build.mjs

@@ -6,6 +6,7 @@
  */
 import { distinctTypefaces } from '../lib/typefaces.mjs';
 import { nearColorPairs } from './../lib/nearpairs.mjs';
+import { neverImportedComponents } from '../lib/neverimported.mjs';
 
 export function rulesMarkdown(h) {
 const repoName = h.profile?.name ?? 'this repo';
@@ -88,13 +89,7 @@ const repoName = h.profile?.name ?? 'this repo';
   }
   
   // ---------- never-imported components ----------
-const dsDirRe = h.profile?.uiDir
-  ? new RegExp(`^${h.profile.uiDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}/`)
-  : /(^|\/)(packages\/ui|design-system|ui-kit)\//;
-const usedFiles = new Set(reusable.filter((c) => c.usageCount > 0).map((c) => c.file));
-const neverImported = reusable.filter((c) => !c.usageCount && dsDirRe.test(c.file)
-  && !/(^|\/)icons?\//.test(c.file)          // glyph sets are deliberately complete
-  && !usedFiles.has(c.file));                 // compound API: an adopted file's sub-exports are surface, not dead
+const neverImported = neverImportedComponents(h.components, h.profile?.uiDir);
 if (neverImported.length >= 3) {
   section('Components nobody imports');
   rule(`${neverImported.length} components are defined but never imported (${neverImported.slice(0, 3).map((c) => `\`<${c.name}>\``).join(', ')}…). Before writing any new component, check this list first; adopt one or flag it for deletion instead of adding another.`);