synthesisui 0.16.61 → 0.16.62

package/dist/skill-import.js

@@ -67,6 +67,23 @@ So if the file says \`"registry": "http://localhost:3000"\`, every command in th
 \`--registry http://localhost:3000\`. If it says production, pass nothing. The CLI now refuses a
 mismatch instead of letting the server reject it, but the point is not to reach that.
 
+**Do this silently.** Which host you are pointed at and which flags follow from it is plumbing,
+and narrating it - *"registry is production, so no --registry flag needed"* - spends the
+person's attention on a decision that was never theirs (dono, 01/08). Say something only when
+there is nothing to say to: no token, or the wrong host.
+
+## How to narrate
+
+The person cares about **what you found in their code** and **what you are about to create**.
+They do not care which flag you passed, which grep you ran, or what you checked and ruled out.
+
+- Report findings, not mechanics. *"Their docs call Ocean the primary branding scale"* earns
+  its line. *"Let me check whether packages/ui exists"* does not.
+- Every decision you make on their behalf belongs in **one** confirmation at the end, not
+  scattered through the work as fait accompli.
+- Never end on a wall of prose that happens to contain a question. If you need an answer, the
+  last thing on screen is the question.
+
 ### 1. Measure
 
 **Always run from the project root, and always twice in a monorepo.** The root is where the
@@ -149,21 +166,43 @@ about which one is the page. Read a screen and see.
 **\`fonts\` and \`concept\`** - the voice, and one paragraph on what this product is. The concept
 feeds every recommendation downstream, so a real one beats a generic one by a wide margin.
 
-### 3. Send it
+### 3. Confirm once, then send
+
+You have made three decisions on their behalf by now - **where** you measured, **what** it will
+be called, and **which values** carry which meaning. Put all three in one place and ask. Not a
+report that contains a question at the bottom: a question.
+
+Offer the alternatives you actually considered, so choosing is a choice and not a veto:
+
+\`\`\`
+I'd create a system from packages/ui, called SignalUI, opening dark.
+
+  from      packages/ui   114 files, 47% of its values already named
+            (apps/web-dashboard, apps/web-review and apps/web-admin
+             are the consumers; measuring all of them gave 36%, which
+             is the average of a light app and two dark ones)
+  called    SignalUI      their own name, from Introduction.mdx
+  brand     #059aed       their docs call Ocean the primary scale
+  opens     dark          data-theme="dark" in the root layout
+
+This creates it on your account. Go ahead, or change any of these?
+\`\`\`
+
+Then, and only after they answer:
 
 \`\`\`
-npx synthesisui import --census _synthesisui/census.json --name "<their name for it>" [--registry <the one from step 0>]
+npx synthesisui import --census _synthesisui/census.json --name "<the name>" [--registry <from step 0>]
 \`\`\`
 
-**One real write, and it creates a system on their account.** Say what you are about to send
-and what it will be called before you run it.
+**This is the one real write.** Everything before it is on their disk and costs nothing to redo.
 
-The CLI asks for a name unless \`--name\` is passed. It does **not** ask about the scheme when
-your reading already answered - a second question would only be a chance to contradict you.
+The CLI asks for a name unless \`--name\` is passed, and it does **not** ask about the scheme when
+your reading already answered - a second question would only be a chance to contradict you. So
+if you skip the confirmation above, nobody is asked about the scope at all, and the first time
+they learn where their system came from is when they open it.
 
-If it refuses, it will tell you which of the two problems it is: no session, an expired one, or
-a token issued by a different host than the one you are sending to. All three are recoverable
-from the census already on disk; none of them need a re-measure.
+If it refuses, it says which of the three it is: no session, an expired one, or a token issued
+by a different host. All are recoverable from the census on disk; none need a re-measure.
 
 ### 4. Tell them exactly what they have, and what is theirs to decide
 

package/package.json

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