synthesisui 0.16.95 → 0.16.96

package/dist/anatomy-read.js

@@ -100,7 +100,10 @@ export function resolveAnatomy(read, declared, deps,
 /** Their name → the slug it reaches in this system. See `RefResolver`. */
 resolve, 
 /** What the component returns, when the skill said and it is not a plain tag. */
-root) {
+root, 
+/** This component's sketch, so a node can name its classes by INDEX instead
+ *  of retyping them - see `AnatomyRead.at`. */
+sketch) {
     const parts = {};
     const composes = [];
     const external = [];
@@ -189,9 +192,16 @@ root) {
                 if (key !== wanted) {
                     notes.push(`two parts named \`${wanted}\` - the second is \`${key}\``);
                 }
-                const classes = typeof node.classes === "string"
-                    ? node.classes.split(/\s+/).filter(Boolean)
-                    : [];
+                /**
+                 * THE CENSUS'S OWN STRING WINS when the node points at it. A retyped
+                 * list is a copy that can lose a modifier; an index cannot.
+                 */
+                const raw = typeof node.classes === "string"
+                    ? node.classes
+                    : typeof node.at === "number"
+                        ? (sketch?.[node.at]?.classes ?? "")
+                        : "";
+                const classes = raw.split(/\s+/).filter(Boolean);
                 const t = transcribe(classes, declared);
                 parts[key] = { base: t.base, dark: t.dark, states: t.states };
                 /**

package/dist/commands/import.js

@@ -1656,7 +1656,10 @@ async function resolveReadParts(census, root) {
     for (const [component, entry] of Object.entries(read)) {
         const anatomy = entry?.anatomy;
         const resolved = Array.isArray(anatomy) && anatomy.length > 0
-            ? resolveAnatomy(anatomy, declared, deps, resolveRef, entry?.root)
+            ? resolveAnatomy(anatomy, declared, deps, resolveRef, entry?.root, 
+            // The component's own sketch, so a node naming itself by index reads
+            // the exact class string the census measured (dono, 01/08).
+            looks[component]?.sketch)
             : Array.isArray(entry?.parts) && entry.parts.length > 0
                 ? resolveFlatParts(entry.parts, declared)
                 : null;

package/dist/commands/upgrade.js

@@ -7,6 +7,7 @@ import { body, section, snippet } from "../output.js";
 import { reactMajorOf, readInstalledConvention } from "../project-facts.js";
 import { fetchChangelog, fetchComponent, fetchDesignSystem, RegistryError, } from "../registry.js";
 import { add } from "./add.js";
+import { doctor } from "./doctor.js";
 /**
  * The highest `v<n>` below `installed` among the folder names given, or the one
  * asked for. Pure, so the version arithmetic can be tested without a disk.
@@ -226,6 +227,26 @@ export async function upgrade(slug, opts) {
         console.log("");
         console.log(body(`⚠ Could not regenerate: ${failed.join(", ")} (removed/renamed in v${latest.version}?)`));
     }
+    /**
+     * THE CHECK RUNS ITSELF - closing the loop the owner asked for end to end
+     * (dono, 01/08).
+     *
+     * An upgrade that lands a v2 whose whole point is "these literals are tokens
+     * now" and then says "ask your agent to migrate" leaves the person with no
+     * way to know whether it worked. The doctor is the answer and it is one
+     * command, so it is not somebody's job to remember: it runs here, over the
+     * same root, and its report IS the receipt.
+     *
+     * Never strict. A finding is information, not a failure of the upgrade, and
+     * exiting non-zero on somebody's own drift would turn a successful install
+     * into a red terminal.
+     */
+    console.log(section("Checking the app against v" + latest.version));
+    await doctor({ dir: root }).catch((err) => {
+        // A doctor that cannot run is not an upgrade that failed - the artifacts
+        // are already on disk and correct.
+        console.log(body(`The check could not run (${err instanceof Error ? err.message : "unknown"}). Run \`npx synthesisui doctor\` when you can.`));
+    });
     console.log(section("Migrate the app"));
     console.log(body(`The migration brief is at _synthesisui/ds/${slug}/UPGRADE.md`));
     console.log("");

package/dist/skill-import.js

@@ -373,14 +373,14 @@ Open the project and answer the questions below. Then add a \`reading\` object t
   "components": {
     "MetricCard": {
       "anatomy": [
-        { "as": "icon", "name": "icon", "classes": "size-8 text-ocean-500" },
+        { "as": "icon", "name": "icon", "at": 1 },
         {
           "as": "stack",
           "name": "body",
-          "classes": "flex flex-col gap-1",
+          "at": 2,
           "children": [
-            { "as": "text", "name": "label", "classes": "text-xs uppercase text-lightgray-500" },
-            { "as": "heading", "name": "value", "classes": "text-2xl font-bold" }
+            { "as": "text", "name": "label", "at": 3 },
+            { "as": "heading", "name": "value", "at": 4 }
           ]
         }
       ]
@@ -388,15 +388,15 @@ Open the project and answer the questions below. Then add a \`reading\` object t
     "ArticleCard": {
       "root": "Card",
       "anatomy": [
-        { "as": "image", "name": "cover", "classes": "aspect-video w-full rounded-t-lg" },
-        { "as": "heading", "name": "title", "classes": "text-lg font-semibold" },
+        { "as": "image", "name": "cover", "at": 1 },
+        { "as": "heading", "name": "title", "at": 2 },
         { "as": "component", "ref": "TextEditor" },
         {
           "as": "row",
           "name": "footer",
-          "classes": "flex items-center gap-2 border-t p-3",
+          "at": 3,
           "children": [
-            { "as": "button", "name": "publish", "classes": "btn btn-primary" },
+            { "as": "button", "name": "publish", "at": 4 },
             { "as": "button", "name": "discard", "classes": "btn btn-ghost" }
           ]
         }
@@ -902,9 +902,22 @@ file for, minus the one thing that is genuinely yours: the NAMES.
 
 Read that and write the anatomy: depth 1 is \`trigger\`, the dot is \`status-dot\`, the
 capitalised tag is a frontier. **Do not open the component file** - if the sketch is
-missing or visibly truncated (60-node cap), say so in not-expressed.md and only then
+missing or visibly truncated (150-node cap), say so in not-expressed.md and only then
 read, because that gap is the census's to close.
 
+**NAME THE NODE BY ITS INDEX - never retype the class string.** Each anatomy node carries
+\`"at": <index into this sketch>\`, and the CLI reads the exact string the census measured:
+
+\`\`\`json
+{ "as": "button", "name": "trigger", "at": 1 }
+\`\`\`
+
+Retyping is where a modifier goes missing. Six real components arrived with \`hover:\` and
+\`focus:\` in their source and no state at all in the recipe, and the parser was not the
+problem - the copy was (audit, dono, 01/08). An index cannot lose a class. \`classes\` still
+works and still wins when you send both, which is for the one node the sketch could not
+reach; every other node uses \`at\`.
+
 ### What the CLI now reads for you, so do not spend a turn on it
 
 **The rule under all of this: you are given EVIDENCE and asked to DECIDE.** You are never

package/package.json

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