synthesisui 0.16.0 → 0.16.2

package/dist/claude-md.js

@@ -138,9 +138,19 @@ instead, because a new token is a decision for a person to make. There is no com
 manifest for an adopted system - the tokens ARE the contract.${SELF_CHECK}`
         : `**When creating or editing components, read the system's GUIDE.md and follow it:** use only semantic tokens
 (\`var(--ds-color-semantic-*)\`, \`--ds-spacing-*\`, etc.), scope the UI with \`data-ds="<slug>"\`,
-and reuse the \`.ds-*\` classes. Do not use raw values outside the system's scale. **Before
-creating any UI element, check the component manifest below - if it exists, use or extend
-it (\`synthesisui component <slug> <name>\` materializes it as your code).** To review a
+and reuse the \`.ds-*\` classes. Do not use raw values outside the system's scale.
+
+**Before creating any UI element, look it up in the manifest below.** If something there
+already covers the purpose, do not write it from scratch - run
+
+    npx synthesisui@latest component <slug> <name>
+
+YOURSELF. It materializes that component as real typed code in this project, and you use and
+extend that. The person who asked you for a feature should never have to know these command
+names or type them; finding the right component is your job, not theirs.
+
+Only write something new when nothing in the manifest covers the purpose - and when you do,
+say which entry you considered and why it did not fit. To review a
 component, create an isolated sample page (e.g. \`app/synthesisui-samples/<component>/\`) - do not
 apply it to real production pages unless asked.${SELF_CHECK}`;
     const body = `## Design Systems (via SynthesisUI)

package/dist/commands/adopt.js

@@ -1,4 +1,4 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
 import { syncClaudeMd } from "../claude-md.js";
 import { parseRootTokens } from "../doctor/tokens.js";
@@ -75,6 +75,34 @@ function guessSlug(tokens, pkgName) {
         .replace(/^-|-$/g, "")
         .toLowerCase() || "my-system");
 }
+/**
+ * A system WE installed, if there is one.
+ *
+ * Run inside a repo already carrying Moments - 158 tokens, 93% coverage - adopt
+ * announced "found no custom properties … if you do not have a system yet,
+ * start from one" (27/07). Telling somebody with a design system that they have
+ * none is the exact dead end this command was written to avoid: our own tokens
+ * live under `_synthesisui/`, which the walk skips, so it looked and found
+ * nothing and drew the wrong conclusion from it.
+ */
+async function installedSystems(root) {
+    const dir = join(root, "_synthesisui", "ds");
+    const slugs = [];
+    for (const e of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
+        if (!e.isDirectory())
+            continue;
+        const raw = await readFile(join(dir, e.name, ".lock"), "utf8").catch(() => "");
+        try {
+            const lock = JSON.parse(raw);
+            if (!lock.adopted)
+                slugs.push(lock.name ?? e.name);
+        }
+        catch {
+            // no readable lock - not something we put there
+        }
+    }
+    return slugs;
+}
 async function findTokens(root, only) {
     let files = 0;
     const from = [];
@@ -146,6 +174,14 @@ export async function adopt(opts) {
     const found = await findTokens(root, opts.tokens);
     console.log(section("Adopt"));
     if (found.tokens.size === 0) {
+        const already = await installedSystems(root);
+        if (already.length > 0) {
+            console.log(body(`${already.join(", ")} ${already.length === 1 ? "is" : "are"} already installed here, and adopt is for a system we did not install.`));
+            console.log("");
+            console.log(body("Nothing to do. To see how the code is holding up:"));
+            console.log(snippet(["npx synthesisui@latest doctor"]));
+            return;
+        }
         // Never "failed to adopt". Always: what was looked for, where, and the
         // next thing to type. Being stuck with no move is the worst outcome.
         console.log(body(`Looked in ${SCOPE_HINT} across ${found.files} stylesheet${found.files === 1 ? "" : "s"} and found no custom properties.`));

package/package.json

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