roast-my-design-system 7.3.3 → 7.5.0

package/README.md

@@ -1,4 +1,4 @@
-<img src="https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/roaster_logo_300px.png?v=7.3.2" width="72" alt="roast-my-design-system">
+<img src="https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/roaster_logo_300px.png?v=7.5.0" width="72" alt="roast-my-design-system">
 
 # roast-my-design-system
 
@@ -10,6 +10,10 @@
 
 A free CLI tool (and Claude Code skill) that roasts your repo's design system with real data, then generates the rules that keep your AI agent on-system.
 
+> **New in 7.5: the kit is read as it is built, and every file left out of a count is named.** A fresh `npx shadcn create` install is told apart from a repo built on one: "The score is the kit's, not yours." A rules file a framework wrote for itself is named as such, and so is the shadcn skill when it is installed. The theme file is found where it is, even when `components.json` points at a file that moved; `button/index.tsx` is a Button. The repaint advice checks whether the theme file holds the variables before telling you to swap to them. And the side panel now lists everything a check leaves out, with the reason and one honest line: your agent reads it anyway. New on that list: the Next.js crash page, an embedded widget's `!important`, and `!important` aimed at a library's own class names.
+
+> **New in 7.4: the score says what it measures, and the report has a new shape.** Under the number: "How safely an AI agent can build on this repo without going off-system." A fixed side panel holds the score, the stack, how the repo was read, an index of every section, and what is not yours and not counted. Installed code splits by one test, does it teach an agent a wrong lesson: shadcn's own bracket values are out of the count and named; palette colours inside an installed registry stay in the score and are never prompted; catalogue stock is not a trap. A factory install scores 100. Leftover theme variables become a fix.
+
 > **New in 7.3: shadcn repos are compared with shadcn repos.** The benchmark carries a shadcn slice, 17 of the 34 fleet repos, and on a shadcn repo every fleet line reads against it: "Avg shadcn repo", "cleaner than 60% of shadcn repos". Ideals and the reputable-systems line stay the same for everyone.
 
 > **New in 7.2: shadcn repos are read as shadcn repos.** The scanner finds the installed catalogue where it actually lives, reads the theme file `components.json` names, and prints how it decided under the report header. 2 new tiles appear on shadcn repos only, both from shadcn's own rules for agents: palette colours in your own code where a theme row exists, and kit components repainted through `className`. Counted per 100 of your own files, never inside the catalogue. The rules file gains a shadcn section. Scores on other repos do not move.
@@ -20,7 +24,7 @@ A free CLI tool (and Claude Code skill) that roasts your repo's design system wi
 
 Run it on your codebase and get, in about a second:
 
-- **A health score you can defend in a meeting.** 0 to 100, deterministic, and benchmarked against 3 yardsticks: Ideal Design System norms, 34 scanned public repos and 10 reputable design systems (Primer, Polaris, Carbon, shadcn/ui…).
+- **A health score you can defend in a meeting.** It measures how safely an AI agent can build new UI on this repo without going off-system. Everything else on the report is receipts for humans. 0 to 100, deterministic, and benchmarked against 3 yardsticks: Ideal Design System norms, 34 scanned public repos and 10 reputable design systems (Primer, Polaris, Carbon, shadcn/ui…).
 - **Per-package scores for monorepos.** One blended number hides which package is the problem: `packages/ui` scores 80 while `apps/web` scores 40, and now you can see it.
 - **Reads React and web components alike.** Stencil, Lit and custom elements are detected by tag registration and counted by kebab tag. Libraries get composition maps, not adoption accusations. Earned token namespaces are named in the header. Anything the scan can not read is declared "not measured" instead of scored.
 - **The receipts behind it.** Every colour and its near-identical twin. Every spacing value, typeface, duplicated or never-imported component, inline style and !important. All with real file paths, in one self-contained HTML report you can open, Slack or email.
@@ -77,11 +81,11 @@ Not to be confused with each other: **"Why this matters"** is generic, ships wit
 
 The full report for vercel/ai-chatbot, top to bottom, including "What the numbers mean", Claude's read of the scan, embedded right under the verdict:
 
-![The full diagnosis report for vercel/ai-chatbot in dark mode: health score, the line saying how the repo was read as a shadcn install, the What the numbers mean analysis written by Claude, priced Where to start moves each with its copy-the-fix-prompt button, the wrapped present with the agent rules, an agent trap callout, 3-yardstick tiles including the 2 shadcn tiles, the adoption map treemap, palette forensics, the shadcn theme variable by variable, spacing receipts, typography specimens, offenders, duplicates, and the component usage ledger](https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/report-full-dark.png?v=7.3.2)
+![The full diagnosis report for vercel/ai-chatbot in dark mode: a fixed side panel with the health score and what it measures, the stack, how the repo was read as a shadcn install, an index of every section and what is not the team's and not counted; then the summary, the What the numbers mean analysis written by Claude, priced Where to start moves each with its copy-the-fix-prompt button, the wrapped present with the agent rules, an agent trap callout, 3-yardstick tiles including the 2 shadcn tiles, the adoption map treemap, palette forensics, the shadcn theme variable by variable, spacing receipts, typography specimens, offenders, duplicates, and the component usage ledger](https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/report-full-dark.png?v=7.5.0)
 
 The same report in light mode (one file, built-in toggle):
 
-![The diagnosis report in light mode](https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/report-light-hero.png?v=7.3.2)
+![The diagnosis report in light mode](https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/report-light-hero.png?v=7.5.0)
 
 ## What makes the numbers trustworthy
 
@@ -235,8 +239,8 @@ After the roast, the skill also offers to write `design-system-rules.md` to disk
 
 - **[telekom/scale](https://gregkozakiewicz.github.io/roast-my-design-system/examples/telekom-scale.html)**: Stencil, 95 components read by tag, with Claude's notes embedded
 - **[adobe/spectrum-web-components](https://gregkozakiewicz.github.io/roast-my-design-system/examples/adobe-spectrum.html)**: Lit, the `--spectrum-*` namespace named in the header
-- **[npx shadcn create, fresh](https://gregkozakiewicz.github.io/roast-my-design-system/examples/shadcn-create-fresh.html)**: a factory install with all 61 components, scanned as is
-- **[vercel/ai-chatbot](https://gregkozakiewicz.github.io/roast-my-design-system/examples/vercel-ai-chatbot.html)**: React, with Claude's notes embedded
+- **[npx shadcn create, fresh](https://gregkozakiewicz.github.io/roast-my-design-system/examples/shadcn-create-fresh.html)**: a factory install with all 61 components, scanned as is and read as fresh
+- **[vercel/ai-chatbot](https://gregkozakiewicz.github.io/roast-my-design-system/examples/vercel-ai-chatbot.html)**: React on shadcn, with Claude's notes embedded
 - **[excalidraw/excalidraw](https://gregkozakiewicz.github.io/roast-my-design-system/examples/excalidraw-excalidraw.html)**
 - **[dubinc/dub](https://gregkozakiewicz.github.io/roast-my-design-system/examples/dubinc-dub.html)**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roast-my-design-system",
-  "version": "7.3.3",
+  "version": "7.5.0",
   "mcpName": "io.github.gregkozakiewicz/roast-my-design-system",
   "description": "Your AI can write the UI. This makes sure it writes your UI. A deterministic scanner scores your design system 0-100 against 34 public repos, reads React and web components (Stencil, Lit), hands you a copy-paste fix prompt for each top finding, writes rules for Claude, Cursor, Copilot and Windsurf with --apply, and runs as a local MCP server with --mcp.",
   "keywords": [

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

@@ -91,8 +91,8 @@
       "note": "palette colours in own code where a theme variable exists, per 100 files"
     },
     "doorOverrides": {
-      "value": 15,
-      "note": "shadcn components given a colour or font through className, per 100 files"
+      "value": 2,
+      "note": "shadcn components given a colour through className, per 100 files; the tidiest half of 16 shadcn repos sit under this (2026-09-13 audit)"
     }
   },
   "stats": {
@@ -1852,7 +1852,7 @@
   },
   "slices": {
     "shadcn": {
-      "builtAt": "2026-09-12T19:02:27.297Z",
+      "builtAt": "2026-09-12T23:43:34.615Z",
       "repoCount": 16,
       "note": "every repo in the fleet the scanner reads as shadcn; the \"cleaner than\" line on a shadcn repo reads against these",
       "stats": {
@@ -2055,7 +2055,7 @@
             5,
             7,
             11,
-            22,
+            21,
             24,
             42,
             47,
@@ -2074,27 +2074,27 @@
         },
         "arbitrary": {
           "values": [
-            12,
-            38,
-            54,
-            100,
-            101,
-            126,
-            128,
-            163,
-            169,
-            245,
-            257,
-            385,
-            386,
-            614,
-            1625,
-            1673
+            5,
+            25,
+            41,
+            74,
+            88,
+            99,
+            113,
+            113,
+            148,
+            204,
+            217,
+            360,
+            366,
+            569,
+            1186,
+            1602
           ],
-          "p25": 101,
-          "median": 166,
-          "p75": 385,
-          "p90": 1120
+          "p25": 85,
+          "median": 131,
+          "p75": 362,
+          "p90": 878
         },
         "nearPairs": {
           "values": [
@@ -2129,20 +2129,20 @@
             0,
             0,
             1,
+            1,
             2,
+            4,
             9,
-            9,
-            12,
-            42,
-            42,
-            55,
-            93,
-            157
+            11,
+            14,
+            34,
+            65,
+            126
           ],
           "p25": 0,
-          "median": 6,
-          "p75": 42,
-          "p90": 74
+          "median": 2,
+          "p75": 12,
+          "p90": 50
         },
         "neverImported": {
           "values": [
@@ -2151,7 +2151,7 @@
             0,
             0,
             1,
-            2,
+            3,
             5,
             13,
             19,
@@ -2205,40 +2205,40 @@
             57,
             58,
             62,
-            67,
+            66,
             100,
-            183,
-            296,
-            491
+            179,
+            297,
+            488
           ],
           "p25": 22,
           "median": 50,
           "p75": 75,
-          "p90": 240
+          "p90": 238
         },
         "doorOverrides": {
           "values": [
             0,
+            0,
+            0,
+            1,
+            1,
+            1,
+            1,
+            1,
+            2,
             3,
-            5,
-            13,
+            4,
+            4,
+            6,
             13,
-            15,
-            16,
-            16,
-            17,
-            18,
-            22,
             26,
-            28,
-            31,
-            44,
-            55
+            32
           ],
-          "p25": 13,
-          "median": 17,
-          "p75": 27,
-          "p90": 38
+          "p25": 1,
+          "median": 2,
+          "p75": 5,
+          "p90": 20
         }
       },
       "repos": [
@@ -2249,7 +2249,7 @@
           "baseColor": "zinc",
           "tailwind": null,
           "codeFiles": 4391,
-          "ownFiles": 811,
+          "ownFiles": 810,
           "metrics": {
             "colors": 310,
             "greys": 66,
@@ -2260,13 +2260,13 @@
             "shadows": 10,
             "exactDuplicates": 134,
             "inlineStyles": 79,
-            "arbitrary": 257,
+            "arbitrary": 217,
             "nearPairs": 18,
-            "important": 157,
+            "important": 126,
             "neverImported": 99,
             "components": 1453,
             "paintTin": 22,
-            "doorOverrides": 5
+            "doorOverrides": 1
           }
         },
         {
@@ -2287,7 +2287,7 @@
             "shadows": 1,
             "exactDuplicates": 0,
             "inlineStyles": 0,
-            "arbitrary": 54,
+            "arbitrary": 41,
             "nearPairs": 0,
             "important": 1,
             "neverImported": 94,
@@ -2314,9 +2314,9 @@
             "shadows": 2,
             "exactDuplicates": 1,
             "inlineStyles": 2,
-            "arbitrary": 12,
+            "arbitrary": 5,
             "nearPairs": 0,
-            "important": 2,
+            "important": 1,
             "neverImported": 0,
             "components": 60,
             "paintTin": 57,
@@ -2330,7 +2330,7 @@
           "baseColor": "neutral",
           "tailwind": "4",
           "codeFiles": 146,
-          "ownFiles": 60,
+          "ownFiles": 68,
           "metrics": {
             "colors": 41,
             "greys": 0,
@@ -2341,13 +2341,13 @@
             "shadows": 4,
             "exactDuplicates": 1,
             "inlineStyles": 7,
-            "arbitrary": 100,
+            "arbitrary": 74,
             "nearPairs": 0,
-            "important": 9,
+            "important": 2,
             "neverImported": 0,
             "components": 316,
-            "paintTin": 67,
-            "doorOverrides": 18
+            "paintTin": 66,
+            "doorOverrides": 1
           }
         },
         {
@@ -2368,13 +2368,13 @@
             "shadows": 0,
             "exactDuplicates": 1,
             "inlineStyles": 11,
-            "arbitrary": 126,
+            "arbitrary": 113,
             "nearPairs": 2,
             "important": 0,
             "neverImported": 100,
             "components": 272,
             "paintTin": 33,
-            "doorOverrides": 17
+            "doorOverrides": 4
           }
         },
         {
@@ -2395,13 +2395,13 @@
             "shadows": 0,
             "exactDuplicates": 16,
             "inlineStyles": 74,
-            "arbitrary": 245,
+            "arbitrary": 204,
             "nearPairs": 18,
             "important": 0,
             "neverImported": 44,
             "components": 811,
             "paintTin": 62,
-            "doorOverrides": 22
+            "doorOverrides": 6
           }
         },
         {
@@ -2411,7 +2411,7 @@
           "baseColor": "slate",
           "tailwind": null,
           "codeFiles": 2604,
-          "ownFiles": 788,
+          "ownFiles": 787,
           "metrics": {
             "colors": 132,
             "greys": 16,
@@ -2422,13 +2422,13 @@
             "shadows": 6,
             "exactDuplicates": 61,
             "inlineStyles": 24,
-            "arbitrary": 169,
+            "arbitrary": 113,
             "nearPairs": 8,
-            "important": 55,
-            "neverImported": 2,
+            "important": 34,
+            "neverImported": 3,
             "components": 1085,
-            "paintTin": 296,
-            "doorOverrides": 31
+            "paintTin": 297,
+            "doorOverrides": 26
           }
         },
         {
@@ -2438,7 +2438,7 @@
           "baseColor": "neutral",
           "tailwind": null,
           "codeFiles": 2141,
-          "ownFiles": 775,
+          "ownFiles": 772,
           "metrics": {
             "colors": 174,
             "greys": 38,
@@ -2449,13 +2449,13 @@
             "shadows": 0,
             "exactDuplicates": 102,
             "inlineStyles": 120,
-            "arbitrary": 163,
+            "arbitrary": 148,
             "nearPairs": 11,
             "important": 0,
             "neverImported": 5,
             "components": 1137,
             "paintTin": 5,
-            "doorOverrides": 16
+            "doorOverrides": 1
           }
         },
         {
@@ -2465,7 +2465,7 @@
           "baseColor": "gray",
           "tailwind": null,
           "codeFiles": 875,
-          "ownFiles": 410,
+          "ownFiles": 409,
           "metrics": {
             "colors": 17,
             "greys": 3,
@@ -2475,14 +2475,14 @@
             "radii": 14,
             "shadows": 0,
             "exactDuplicates": 17,
-            "inlineStyles": 22,
-            "arbitrary": 38,
+            "inlineStyles": 21,
+            "arbitrary": 25,
             "nearPairs": 1,
             "important": 0,
             "neverImported": 19,
             "components": 700,
             "paintTin": 100,
-            "doorOverrides": 3
+            "doorOverrides": 1
           }
         },
         {
@@ -2492,7 +2492,7 @@
           "baseColor": "gray",
           "tailwind": "3",
           "codeFiles": 1379,
-          "ownFiles": 531,
+          "ownFiles": 534,
           "metrics": {
             "colors": 66,
             "greys": 14,
@@ -2503,13 +2503,13 @@
             "shadows": 1,
             "exactDuplicates": 20,
             "inlineStyles": 47,
-            "arbitrary": 386,
+            "arbitrary": 360,
             "nearPairs": 7,
-            "important": 42,
+            "important": 14,
             "neverImported": 13,
             "components": 777,
-            "paintTin": 491,
-            "doorOverrides": 55
+            "paintTin": 488,
+            "doorOverrides": 32
           }
         },
         {
@@ -2519,7 +2519,7 @@
           "baseColor": "slate",
           "tailwind": "3",
           "codeFiles": 2120,
-          "ownFiles": 340,
+          "ownFiles": 349,
           "metrics": {
             "colors": 254,
             "greys": 52,
@@ -2530,13 +2530,13 @@
             "shadows": 0,
             "exactDuplicates": 21,
             "inlineStyles": 5,
-            "arbitrary": 128,
+            "arbitrary": 99,
             "nearPairs": 21,
             "important": 9,
             "neverImported": 0,
             "components": 911,
-            "paintTin": 183,
-            "doorOverrides": 15
+            "paintTin": 179,
+            "doorOverrides": 3
           }
         },
         {
@@ -2557,13 +2557,13 @@
             "shadows": 0,
             "exactDuplicates": 25,
             "inlineStyles": 42,
-            "arbitrary": 101,
+            "arbitrary": 88,
             "nearPairs": 0,
             "important": 0,
             "neverImported": 1,
             "components": 246,
             "paintTin": 42,
-            "doorOverrides": 13
+            "doorOverrides": 4
           }
         },
         {
@@ -2584,13 +2584,13 @@
             "shadows": 0,
             "exactDuplicates": 14,
             "inlineStyles": 47,
-            "arbitrary": 385,
+            "arbitrary": 366,
             "nearPairs": 10,
-            "important": 12,
+            "important": 4,
             "neverImported": 0,
             "components": 1204,
             "paintTin": 21,
-            "doorOverrides": 26
+            "doorOverrides": 0
           }
         },
         {
@@ -2611,13 +2611,13 @@
             "shadows": 10,
             "exactDuplicates": 65,
             "inlineStyles": 58,
-            "arbitrary": 614,
+            "arbitrary": 569,
             "nearPairs": 16,
-            "important": 42,
+            "important": 11,
             "neverImported": 30,
             "components": 1494,
             "paintTin": 58,
-            "doorOverrides": 28
+            "doorOverrides": 2
           }
         },
         {
@@ -2627,7 +2627,7 @@
           "baseColor": "neutral",
           "tailwind": "4",
           "codeFiles": 1775,
-          "ownFiles": 605,
+          "ownFiles": 604,
           "metrics": {
             "colors": 187,
             "greys": 51,
@@ -2638,13 +2638,13 @@
             "shadows": 2,
             "exactDuplicates": 104,
             "inlineStyles": 117,
-            "arbitrary": 1673,
+            "arbitrary": 1186,
             "nearPairs": 21,
             "important": 0,
             "neverImported": 26,
             "components": 971,
             "paintTin": 32,
-            "doorOverrides": 44
+            "doorOverrides": 1
           }
         },
         {
@@ -2665,13 +2665,13 @@
             "shadows": 14,
             "exactDuplicates": 288,
             "inlineStyles": 263,
-            "arbitrary": 1625,
+            "arbitrary": 1602,
             "nearPairs": 59,
-            "important": 93,
+            "important": 65,
             "neverImported": 23,
             "components": 3630,
             "paintTin": 8,
-            "doorOverrides": 16
+            "doorOverrides": 0
           }
         }
       ]