roast-my-design-system 7.5.0 → 7.6.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.5.0" 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.6.0" width="72" alt="roast-my-design-system">
 
 # roast-my-design-system
 
@@ -10,6 +10,8 @@
 
 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.6: a fourth repo profile, `registry`.** A repo that publishes a shadcn registry is read as a registry, not as an app that installed shadcn. Recognition: a `registry.json` with typed items (`registry:ui`, `registry:style`, ...) or a route that builds one from a packages folder. Covers shadcn's own source, magicui, kibo-ui and tweakcn. The header states what the repo publishes (components, blocks, styles, demos) and how many variants of the same components it keeps. Scoring is unchanged in this release: a registry is measured with the shadcn tiles against the shadcn slice, and the registry counting rules follow in the next one. `summary.json` gains `kind: "registry"` and a `registry` block. Also in 7.6: the theme file is checked for the variables tweakcn adds to every export, shown as a `tweakcn theme` pill on a match; typefaces declared in a single file are reported as a picker rather than as N typefaces.
+
 > **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.
@@ -81,11 +83,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: 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 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.6.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.5.0)
+![The diagnosis report in light mode](https://raw.githubusercontent.com/gregkozakiewicz/roast-my-design-system/main/assets/report-light-hero.png?v=7.6.0)
 
 ## What makes the numbers trustworthy
 
@@ -235,12 +237,13 @@ After the roast, the skill also offers to write `design-system-rules.md` to disk
 
 ## Live examples
 
-5 real roasts of public repos, hosted as-is (the same self-contained HTML the skill generates), spanning React, Stencil and Lit:
+7 real roasts of public repos, hosted as-is (the same self-contained HTML the skill generates), spanning React, Stencil and Lit:
 
 - **[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 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
+- **[magicuidesign/magicui](https://gregkozakiewicz.github.io/roast-my-design-system/examples/magicui.html)**: read as a shadcn registry, what it publishes named under the score
 - **[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.5.0",
+  "version": "7.6.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/diagnose/index.mjs

@@ -33,6 +33,7 @@ import { WHY } from './why.mjs';
 import { parseColor, luminance, isGrey } from '../lib/color.mjs';
 import { loadBenchmark, benchHelpers, makeHealthOf, coreMetrics, tileHealths, scoreOfTiles, scoreBreakdown, scorePackage as scorePackageOf, ZERO_IDEAL, WARN_TOLERANCE, SCORE_OF, SCHEMA_VERSION } from './score.mjs';
 import { ownSpacing, profileOf, installedDirs, splitArbitrary } from '../profiles/index.mjs';
+import { publishesLine } from '../profiles/registry.mjs';
 
 // The benchmark and every judgement made against it live in score.mjs; this
 // file only draws. The same numbers reach summary.json through scoreHarvest.
@@ -285,7 +286,12 @@ const offenders = h.tokens.offenders ?? [];
 const candidates = [];
 const effColors = tokenLed ? colorStrays : colors.length;
 const effGreys = tokenLed ? greyStrays : greys.length;
-if (typefaces.length > 3) candidates.push({ ratio: typefaces.length / 3, text: `${typefaces.length} typefaces. Most products use 2 or 3` });
+// Every typeface declared in one file is a picker (a theme editor's font
+// list, shadcn's docs site): one choice offered, one in use at a time.
+const fontFiles = new Set(fontFamilies.flatMap((f) => (f.files ?? []).map((x) => x.file)));
+const fontPicker = typefaces.length > 3 && fontFiles.size === 1 ? [...fontFiles][0] : null;
+if (fontPicker) candidates.push({ ratio: 1.05, text: `${typefaces.length} typefaces offered by a picker in one file (${basename(fontPicker)}), one in use at a time` });
+else if (typefaces.length > 3) candidates.push({ ratio: typefaces.length / 3, text: `${typefaces.length} typefaces. Most products use 2 or 3` });
 else if (typefaces.length && fontFamilies.length > 6) candidates.push({ ratio: fontFamilies.length / 6, text: `${typefaces.length} typeface${typefaces.length > 1 ? 's' : ''} declared ${fontFamilies.length} different ways` });
 if (effColors > 24 * 1.25) candidates.push({ ratio: effColors / 24, text: tokenLed
   ? `${n(colorStrays)} hardcoded colours outside the token set, your agent will happily copy them at random`
@@ -607,7 +613,7 @@ function sheetSection() {
     if (sheet.shadcnMissing?.length) bits.push(`${sheet.shadcnMissing.length} of the ${SHADCN_ROW_COUNT} current shadcn variables not defined (${sheet.shadcnMissing.slice(0, 4).map((r) => `--${esc(r)}`).join(', ')}${sheet.shadcnMissing.length > 4 ? '…' : ''})${sheet.hslEra ? ', normal for an install from before the chart and sidebar rows existed' : ''}`);
     if (sheet.missingDark?.length) bits.push(`${sheet.missingDark.length} variable${sheet.missingDark.length === 1 ? '' : 's'} with no dark value (${sheet.missingDark.slice(0, 4).map((r) => `--${esc(r)}`).join(', ')})`);
     if (sheet.custom?.length) bits.push(`${sheet.custom.length} custom variable${sheet.custom.length === 1 ? '' : 's'} of your own (${sheet.custom.slice(0, 5).map((r) => `--${esc(r)}`).join(', ')}${sheet.custom.length > 5 ? '…' : ''})${sheet.customMissingDark?.length ? `, ${sheet.customMissingDark.length} of them light only` : ''}${sheet.customUnregistered?.length ? `, ${sheet.customUnregistered.length} never mapped in @theme inline` : ''}`);
-    if (sheet.tweakcnPresent >= 10) bits.push('tweakcn variables present: shadows and letter-spacing are themed');
+    if (sheet.tweakcnPresent >= 10) bits.push(`a tweakcn theme: ${sheet.tweakcnPresent} of the rows tweakcn adds to every theme it exports are here (shadows, letter-spacing, spacing), so the theme came from a theme editor or copied its shape, and updates will come from there too`);
     if (sheet.spacingChanged) bits.push(`<b>--spacing is ${esc(sheet.spacing)}</b>, not the default 0.25rem: this resizes every gap in the app at once, which shadcn\'s own changelog says never to do`);
     parts.push(`<div class="receipts">${eyebrow('the theme file, variable by variable')}<p class="sub">${bits.join(' · ')}.</p></div>`);
   } else if (sheet) {
@@ -1317,6 +1323,12 @@ function shadcnReceipt() {
     const pages = comps.filter((c) => c.isPage && f.ownFiles.includes(c.file)).length;
     return `<div class="excl fresh">It is a fresh shadcn install${k?.style ? ` (style ${esc(k.style)}${k.baseColor ? `, base colour ${esc(k.baseColor)}` : ''}${k.tailwind ? `, Tailwind ${esc(k.tailwind)}` : ''})` : ''}. Nothing of your own yet: ${n(doors)} component${doors === 1 ? '' : 's'} installed, the theme file untouched, ${pages === 1 ? 'one demo page' : `${pages} pages`}. <b>The score is the kit's, not yours.</b> Run this again once you have built a few screens.</div><div class="excl">Evidence: ${receipt}</div>`;
   }
+  if (P.isRegistry && P.registry) {
+    const r = P.registry;
+    const what = r.builtFrom ? `publishes ${r.items} component${r.items === 1 ? '' : 's'}, built from its packages folder` : `publishes ${esc(publishesLine(r))}`;
+    const pages = comps.filter((c) => c.isPage).length;
+    return `<div class="excl fresh">Read as a shadcn registry: ${what}${r.variants.length ? `, the same components kept in ${r.variants.length} variants` : ''}.${pages ? ` Its own site: ${n(pages)} page${pages === 1 ? '' : 's'}.` : ''} Scored as a shadcn install for now; the registry rules come next.</div><div class="excl">Evidence: ${receipt}</div>`;
+  }
   return `<div class="excl">Read as a shadcn install (${esc(P.confidence ?? 'medium')} confidence): ${receipt}</div>`;
 }
 
@@ -1350,7 +1362,7 @@ function sidePanel() {
     ? `<div class="bd">Of which <b>${breakdown.installedPoints} point${breakdown.installedPoints === 1 ? '' : 's'}</b> come from installed code you did not write: ${esc(rp.dirs.map((d) => basename(d)).join(', '))} (${n(rp.files)} file${rp.files === 1 ? '' : 's'}, ${n(rp.tinUses)} palette colour${rp.tinUses === 1 ? '' : 's'}). Your own code alone would score <b>${breakdown.ownScore}</b>. Kept in the score because your agent reads those files like everything else; left out of the fixes because they are not yours to edit.</div>` : '';
   const scoreBlock = healthScore !== null
     ? `<div class="score${noSystemLikely ? ' muted' : ''}">${eyebrow('Health score')}<div class="val">${healthScore}<span class="slash">/</span><span class="of">100</span></div>${noSystemLikely ? '<div class="note">little here to score · see the note</div>' : ''}<div class="def">${def}${lift}</div>${bd}</div>` : '';
-  const chips = `<div class="chips">${stack.map((c) => `<span class="chip">${esc(c)}</span>`).join('')}${dsUnrecognised ? '<span class="chip chip-dim">design system: unrecognised</span>' : ''}${legacyChip ? `<span class="chip chip-dim">${esc(legacyChip)}</span>` : ''}${agentFiles.map((c) => `<span class="chip chip-agent">${esc(c.file)}</span>`).join('')}</div>`;
+  const chips = `<div class="chips">${stack.map((c) => `<span class="chip">${esc(c)}</span>`).join('')}${(P.shadcn?.sheet?.tweakcnPresent ?? 0) >= 10 ? '<span class="chip">tweakcn theme</span>' : ''}${dsUnrecognised ? '<span class="chip chip-dim">design system: unrecognised</span>' : ''}${legacyChip ? `<span class="chip chip-dim">${esc(legacyChip)}</span>` : ''}${agentFiles.map((c) => `<span class="chip chip-agent">${esc(c.file)}</span>`).join('')}</div>`;
   const facts = [
     shadcnReceipt(),
     exclusionsLine(),
@@ -2027,6 +2039,7 @@ if (summaryPath) {
     verdict,
     role: P.role,
     kind: P.kind,
+    ...(P.isRegistry && P.registry ? { registry: { source: P.registry.source, builtFrom: P.registry.builtFrom, items: P.registry.items, publishes: P.registry.publishes, variants: P.registry.variants } } : {}),
     ...(P.isShadcn && P.shadcn ? { shadcn: { confidence: P.confidence, evidence: P.evidence, style: P.shadcn.kit?.style ?? null, baseColor: P.shadcn.kit?.baseColor ?? null, tailwind: P.shadcn.kit?.tailwind ?? null, catalogues: P.uiDirs, registries: P.shadcn.registryDirs ?? [], ...(P.shadcn.registryPaint ? { registryFiles: P.shadcn.registryPaint.files, registryPaletteColours: P.shadcn.registryPaint.tinUses } : {}), ownFiles: P.shadcn.paint?.ownFiles ?? null, fresh: P.shadcn.fresh?.fresh === true } } : {}),
     componentsMeasured,
     metrics: (({ colors, colorTokens, colorStrays, greys, greyStrays, spacing, exactDuplicates, inlineStyles, nearPairs, important, neverImported, arbitrary, tokenLed }) =>

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

@@ -45,7 +45,8 @@ export function loadBenchmark() {
  * ideals and the reputable-systems line are the same for every kind.
  */
 export function benchHelpers(bench, kind = 'product') {
-  const slice = bench?.slices?.[kind] ?? null;
+  // registries are compared with the shadcn repos, labelled as such (Greg, 2026-09-13)
+  const slice = bench?.slices?.[kind === 'registry' ? 'shadcn' : kind] ?? null;
   if (slice?.stats) bench = { ...bench, stats: { ...(bench?.stats ?? {}), ...slice.stats } };
   const sliceInfo = slice ? { kind, repoCount: slice.repoCount, builtAt: slice.builtAt } : null;
   // where does this value sit among the scanned fleet? ("more colours than 90%")
@@ -105,6 +106,8 @@ export const PROFILE_TILES = {
     ['doorOverrides', 'components recoloured from outside per 100 files'],
   ],
 };
+// a registry measures what a shadcn repo measures (release (a), 2026-09-13)
+PROFILE_TILES.registry = PROFILE_TILES.shadcn;
 export const tilesFor = (kind) => [...TILES, ...(PROFILE_TILES[kind] ?? [])];
 
 /** The tiles, in report order: metric key, the label the report prints. */

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

@@ -1,7 +1,7 @@
 // Single version constant for the engine — imported by diagnose (report
 // footer) and rules (generated-by line). This is the bump spot that used to
 // live as a const inside diagnose/index.mjs.
-export const VERSION = '7.5.0';
+export const VERSION = '7.6.0';
 // The shape of harvest.json and summary.json. Bumped only when a field is
 // renamed, removed or changes meaning; a new field is not a new schema. A
 // tool comparing two scans compares like with like by this number, not by VERSION.

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

@@ -1,5 +1,5 @@
 import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, basename } from 'node:path';
 /**
  * Profiles — what kind of repo is this, decided once and read everywhere.
  *
@@ -22,6 +22,7 @@ import { join } from 'node:path';
  * fixture's expected output is byte-identical before and after.
  */
 import shadcn from './shadcn.mjs';
+import { readRegistry, publishesLine, variantsFromDirs } from './registry.mjs';
 import library from './library.mjs';
 import product from './product.mjs';
 
@@ -60,6 +61,23 @@ export function decideProfile(profile, components, files, root = null) {
   profile.kind = picked.kind;
   profile.kindConfidence = decision.confidence;
   profile.kindEvidence = decision.evidence;
+  // A shadcn repo that PUBLISHES a registry is a registry: the fourth kind.
+  // Every count still reads the shadcn facts (release (a): zero score change);
+  // the kind, the receipt and the header line say what it is.
+  if (picked === shadcn && root) {
+    const reg = readRegistry(root, files);
+    if (reg) {
+      if (!reg.variants.length) reg.variants = variantsFromDirs(reg, profile.uiDirs, files);
+      delete reg.itemNames;
+      profile.kind = 'registry';
+      profile.registry = reg;
+      profile.kindEvidence = [
+        reg.builtFrom ? `registry built from ${reg.items} packages by ${reg.source}` : `${reg.source} publishes ${publishesLine(reg)}`,
+        ...(reg.variants.length ? [`the same components kept in ${reg.variants.length} variants (${reg.variants.map((d) => basename(d)).join(', ')})`] : []),
+        ...decision.evidence,
+      ];
+    }
+  }
 
   // Measurability. The gate fires on the situation, never a list of known
   // frameworks: a repo with real code volume where the detector found almost
@@ -90,7 +108,10 @@ export function profileOf(h) {
     confidence: p.kindConfidence ?? null,
     evidence: p.kindEvidence ?? [],
     isLibrary: role === 'library',
-    isShadcn: kind === 'shadcn',
+    // a registry is read with the shadcn facts, plus what it publishes
+    isShadcn: kind === 'shadcn' || kind === 'registry',
+    isRegistry: kind === 'registry',
+    registry: p.registry ?? null,
     shadcn: p.shadcn ?? null,
     uiDirs: p.uiDirs ?? (p.uiDir ? [p.uiDir] : []),
     // A vendored shadcn catalogue is stock on a shelf, not abandonment.

package/skills/roast-my-design-system/scripts/profiles/registry.mjs

@@ -0,0 +1,164 @@
+/**
+ * Registry: a project that publishes components or themes for other repos
+ * to install with the shadcn CLI (shadcn's own source, magicui, kibo-ui,
+ * tweakcn). Read as an ordinary shadcn install, the scanner counts its
+ * product range as sprawl (shadcn's source: 132 duplicates, one per base
+ * library; 29 typefaces from a font picker) and files what it publishes
+ * under "installed, not yours". Both wrong: what a registry publishes ships
+ * into every repo that installs it.
+ *
+ * Release (a), 2026-09-13: recognition and the header line only. Every count
+ * still reads the shadcn profile, so no score moves. Release (b) brings the
+ * counting rules (variants once, published code as own code, the theme
+ * check, the demo zone out). Brief: DOCs/proffer-2-notes/docs/registry-profile-brief-2026-09-13.md
+ *
+ * Recognised by either:
+ *   1. a registry.json whose items carry registry:* types (the source file,
+ *      never the built copies under public/ nor test fixtures or templates)
+ *   2. a route that builds the registry from a packages folder
+ *      (app/r/registry.json/route.ts, kibo-ui)
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+
+const readJSON = (p) => { try { return JSON.parse(readFileSync(p, 'utf8')); } catch { return null; } };
+
+// registry item types → the words the report uses
+const KINDS = [
+  ['components', /^registry:(ui|component)$/],
+  ['blocks', /^registry:block$/],
+  ['styles', /^registry:(style|theme)$/],
+  ['demos', /^registry:example$/],
+  ['other', /^registry:(lib|hook|file|page|internal)$/],
+];
+
+function tally(items) {
+  const out = { components: 0, blocks: 0, styles: 0, demos: 0, other: 0 };
+  for (const it of items) {
+    const t = String(it?.type ?? '');
+    const k = KINDS.find(([, re]) => re.test(t));
+    if (k) out[k[0]] += 1;
+  }
+  return out;
+}
+
+/** Sibling folders holding the same published component names: the variants of one range. */
+function variantDirs(items, root) {
+  const byName = new Map();
+  for (const it of items) {
+    if (!/^registry:(ui|component)$/.test(String(it?.type ?? ''))) continue;
+    for (const f of it.files ?? []) {
+      const p = typeof f === 'string' ? f : f?.path;
+      if (!p) continue;
+      const dir = dirname(p);
+      if (!byName.has(it.name)) byName.set(it.name, new Set());
+      byName.get(it.name).add(dir);
+    }
+  }
+  const dirs = new Map();
+  for (const set of byName.values()) if (set.size > 1) for (const d of set) dirs.set(d, (dirs.get(d) ?? 0) + 1);
+  return [...dirs.entries()].filter(([, n]) => n >= 5).map(([d]) => d).sort();
+}
+
+/**
+ * The facts a registry publishes, or null when the repo publishes nothing.
+ * @returns {{ source: string, builtFrom: string|null, items: number, publishes, variants: string[] } | null}
+ */
+// The main walk skips docs/, public/ and test folders on purpose (they are
+// not the product's design language). A registry's paperwork lives exactly
+// there (kibo's route under apps/docs, tweakcn's built JSON under public), so
+// recognition takes its own small look: depth-limited, noise skipped.
+const LOOK_SKIP = new Set(['node_modules', '.git', 'dist', 'build', 'out', '.next', 'coverage', '.turbo', 'test', 'tests', '__tests__', 'fixtures', 'templates']);
+function lookFor(root, maxDepth = 6) {
+  const found = { registries: [], routes: [] };
+  const walk = (dir, rel, depth) => {
+    if (depth > maxDepth) return;
+    let es; try { es = readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of es) {
+      const r = rel ? `${rel}/${e.name}` : e.name;
+      if (e.isDirectory()) {
+        if (LOOK_SKIP.has(e.name) || (e.name.startsWith('.') && e.name !== '.')) continue;
+        if (e.name === 'registry.json') {
+          const route = ['route.ts', 'route.js', 'route.tsx', 'route.mjs'].find((n) => existsSync(join(dir, e.name, n)));
+          if (route && basename(dir) === 'r') found.routes.push(`${r}/${route}`);
+          continue;
+        }
+        walk(join(dir, e.name), r, depth + 1);
+      } else if (e.name === 'registry.json') found.registries.push(r);
+    }
+  };
+  walk(root, '', 0);
+  return found;
+}
+
+export function readRegistry(root, files) {
+  const look = lookFor(root);
+  // 1. a registry.json with typed items: the source file first (the biggest
+  // wins), else the built copy under public/ (tweakcn generates its registry
+  // from a TypeScript file and only the built JSON exists)
+  let best = null;
+  const consider = (f) => {
+    const j = readJSON(join(root, f));
+    const items = Array.isArray(j?.items) ? j.items : null;
+    if (!items || !items.some((it) => /^registry:/.test(String(it?.type ?? '')))) return;
+    if (!best || items.length > best.items.length) best = { source: f, items };
+  };
+  const candidates = look.registries;
+  for (const f of candidates.filter((f) => !/(^|\/)public\//.test(f))) consider(f);
+  if (!best) for (const f of candidates.filter((f) => /(^|\/)public\//.test(f))) consider(f);
+  if (best) {
+    const publishes = tally(best.items);
+    const itemNames = best.items.filter((it) => /^registry:(ui|component)$/.test(String(it?.type ?? ''))).map((it) => it.name).filter(Boolean);
+    return { source: best.source, builtFrom: null, items: best.items.length, publishes, variants: variantDirs(best.items, root), itemNames };
+  }
+  // 2. a route that builds the registry from packages/* (kibo-ui)
+  const route = look.routes[0] ?? null;
+  if (route) {
+    const src = readFileSync(join(root, route), 'utf8');
+    if (/packages/.test(src)) {
+      // the packages folder nearest the route's app, walking up
+      let dir = dirname(route);
+      let pkgs = null;
+      while (dir && dir !== '.') {
+        const cand = join(root, dir, 'packages');
+        if (existsSync(cand)) { pkgs = cand; break; }
+        dir = dirname(dir);
+      }
+      if (!pkgs && existsSync(join(root, 'packages'))) pkgs = join(root, 'packages');
+      if (pkgs) {
+        const names = readdirSync(pkgs, { withFileTypes: true }).filter((e) => e.isDirectory() && existsSync(join(pkgs, e.name, 'index.tsx'))).map((e) => e.name);
+        return { source: route, builtFrom: 'packages', items: names.length, publishes: { components: names.length, blocks: 0, styles: 0, demos: 0, other: 0 }, variants: [] };
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Variants found on disk: catalogue folders (the shadcn profile's uiDirs)
+ * that each hold most of the published component names. shadcn's own
+ * registry.json lists one file per component (new-york-v4), while the same
+ * components sit again under bases/aria, bases/base and bases/radix.
+ */
+export function variantsFromDirs(reg, uiDirs, files) {
+  const names = new Set();
+  // names come from the registry items when it is a file, else from packages
+  if (reg.itemNames) for (const nm of reg.itemNames) names.add(nm);
+  if (names.size < 5) return [];
+  const stem = (f) => { const b = basename(f).replace(/\.[cm]?[jt]sx?$/, ''); return b === 'index' ? basename(dirname(f)) : b; };
+  const hits = [];
+  for (const d of uiDirs ?? []) {
+    const have = new Set((files.code ?? []).filter((f) => f.startsWith(`${d}/`) && /\.[jt]sx$/.test(f)).map(stem));
+    const shared = [...names].filter((nm) => have.has(nm)).length;
+    if (shared >= Math.max(5, Math.ceil(names.size * 0.5))) hits.push(d);
+  }
+  return hits.length > 1 ? hits.sort() : [];
+}
+
+/** The header sentence: what it publishes, in words. */
+export function publishesLine(r) {
+  const parts = [];
+  const n = (k, word) => { const v = r.publishes[k]; if (v) parts.push(`${v} ${word}${v === 1 ? '' : 's'}`); };
+  n('components', 'component'); n('blocks', 'block'); n('styles', 'style'); n('demos', 'demo');
+  return parts.length ? parts.join(', ').replace(/, ([^,]*)$/, ' and $1') : `${r.items} items`;
+}

package/skills/roast-my-design-system/scripts/profiles/shadcn.mjs

@@ -303,6 +303,9 @@ export default {
     }
     evidence.push(contract ? `${contract} of shadcn's ${CONTRACT_ROWS.length} theme variables defined` : 'no shadcn theme variables found in any stylesheet');
     if (kit?.style) evidence.push(`style ${kit.style}${kit.baseColor ? `, base colour ${kit.baseColor}` : ''}${kit.tailwind ? `, Tailwind ${kit.tailwind}` : ''}`);
+    // ten or more of the rows tweakcn adds to every theme it exports: a
+    // fingerprint of a theme editor, not a signature, so "tweakcn-style"
+    if ((sheet?.tweakcnPresent ?? 0) >= 10) evidence.push(`tweakcn theme (${sheet.tweakcnPresent} of its rows present)`);
 
     // 4. write the facts every consumer reads
     profile.uiDirs = installs.map((i) => i.uiDir).filter(Boolean);