synthesisui 0.16.40 → 0.16.42

package/dist/commands/doctor.js

@@ -38,6 +38,10 @@ const SKIP = new Set([
     "build",
     "out",
     "coverage",
+    // Storybook's build output. Its bundled manager JS carries Storybook's OWN
+    // brand palette, and a census of a component library came back led by
+    // #1EA7FD and #FF4785 - Storybook's blue and pink, not the library's.
+    "storybook-static",
     ".turbo",
     ".vercel",
     // Our own installed artifacts are the answer, not the problem.
@@ -61,9 +65,16 @@ skippedProjects) {
         if (e.isDirectory()) {
             if (SKIP.has(e.name))
                 continue;
-            // A CHILD directory carrying its own _synthesisui is a separately
+            // A CHILD directory carrying its own INSTALLED SYSTEM is a separately
             // governed project - its record, its doctor, its numbers.
-            const governed = await readdir(join(full, "_synthesisui")).then(() => true, () => false);
+            //
+            // The test used to be "does `_synthesisui/` exist", and that folder holds
+            // more than a system: `import --dry` writes a census into it. So the
+            // recommended sequence defeated itself (dono, 30/07) - importing from
+            // `packages/ui` left a census there, and the next `doctor apps/…` skipped
+            // the shared package as if it governed itself, taking its 92 tokens with
+            // it. Governance means an installed system, which is `ds/`.
+            const governed = await readdir(join(full, "_synthesisui", "ds")).then((entries) => entries.length > 0, () => false);
             if (governed) {
                 skippedProjects?.push(full);
                 continue;
@@ -359,7 +370,20 @@ export async function doctor(opts) {
     // Nothing of ours here does not mean nothing to measure against. Fall back
     // to whatever vocabulary the project already declares for itself.
     if (table.byName.size === 0) {
-        table = await harvestOwnTokens(scopes.length > 0 ? scopes : [root]);
+        /**
+         * THEIR VOCABULARY IS REPO-WIDE, even when the READING is scoped.
+         *
+         * A path argument scopes what gets measured; it must not scope what counts
+         * as named. Measured on a real monorepo (dono, 30/07):
+         * `doctor apps/web-dashboard` found 28 tokens and missed the 112 that live
+         * in `packages/ui` - the shared package that IS that company's design
+         * system. Every value the app borrows from it was reported as having no
+         * name, which inverts the one sentence this command exists to say.
+         *
+         * Same rule our own installed system already follows: found from the root,
+         * measured in the scope.
+         */
+        table = await harvestOwnTokens([root]);
     }
     const hasSystem = table.byName.size > 0;
     const reports = [];

package/dist/doctor/scan.js

@@ -235,7 +235,17 @@ const IDIOM = new Set(["0", "0px", "1px", "9999px", "100%", "50%"]);
  *  spec is the TEST, not drift. Every real project has these; accusing them
  *  buried the report's real findings under 99 phantom lines the first time
  *  the doctor ran on a repo with its own test suite (30/07). */
-const IS_FIXTURE = /(\.(spec|test)\.[a-z]+$|__tests__\/|\/fixtures?\/)/;
+/**
+ * Files whose colours are not the product's.
+ *
+ * Tests and fixtures were always here. STORIES joined them after a component
+ * library was imported and its census came back describing demo content
+ * (dono, 30/07): a story paints a plausible article, a fake avatar, a swatch
+ * grid - values chosen to show the component off, never shipped to anyone.
+ * Counting them accuses the author of drift they did not write, and crediting
+ * them inflates a coverage number nobody can act on.
+ */
+const IS_FIXTURE = /(\.(spec|test|stories)\.[a-z]+$|__tests__\/|\/fixtures?\/|(^|\/)\.storybook\/)/;
 export function scanSource(file, source, table) {
     if (IS_FIXTURE.test(file)) {
         const real = scanCore(file, source, table);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.40",
+  "version": "0.16.42",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {