synthesisui 0.16.240 → 0.16.242

package/dist/commands/align.js

@@ -7,6 +7,7 @@ import { readToken, resolveRegistry } from "../config.js";
 import { unsentEvents } from "../doctor/ledger.js";
 import { CHECKER_SINCE, installedBehind, MATERIALISER_SINCE, READER_SINCE, } from "../install-marks.js";
 import { measuredScope } from "../measured-scope.js";
+import { body } from "../output.js";
 import { SKILLS } from "../skills.js";
 /**
  * QUAL CLI MEDIU O CENSO EM DISCO - e era o `reader`, um inteiro, até 11/08.
@@ -486,17 +487,54 @@ export async function misalignments(root, opts = {}) {
         items.push(remote);
     return items;
 }
+/**
+ * O ESTADO DE QUEM AINDA NÃO TEM SISTEMA - o silêncio que custava a jornada inteira.
+ *
+ * `localMisalignments` devolve lista VAZIA quando não há sistema instalado, e a razão está escrita
+ * lá em cima: um repo sem DS não está desalinhado, ele só não começou. Correto - e o efeito é que a
+ * pessoa que acabou de rodar `connect`, que é exatamente quem mais precisa de uma instrução, abre a
+ * primeira sessão do agente em silêncio absoluto. A frase do próximo passo mora hoje na aba do
+ * browser que ela acabou de deixar; se fechou a aba, ou voltou no dia seguinte, não existe mais
+ * nada dizendo o que fazer.
+ *
+ * Então isto não é um desalinho e não entra naquela lista: é uma frase de ESTADO, e ela fala em
+ * forma de CONVERSA. "Peça ao seu agente: importe meu design system" é executável por quem está
+ * lendo - um comando decorado não é, e a esta altura ela nem sabe que comandos existem.
+ *
+ * DOIS ESTADOS, e não três. O terceiro que o plano previa - "instalado mas não fiado" - ficou de
+ * fora com motivo medido: a única leitura confiável de fiação (`readWiring`, no doctor) varre o
+ * repositório inteiro, e isto roda em TODA abertura de sessão. Um aviso que custa um walk completo
+ * a cada sessão é um aviso que alguém desliga.
+ */
+export async function nextStepFor(root) {
+    const locks = (await locksIn(root)).filter((l) => l.slug && !l.adopted);
+    if (locks.length > 0)
+        return null;
+    const measured = await readFile(join(root, "_synthesisui", "census.json"), "utf8").then(() => true, () => false);
+    return measured
+        ? 'This repo has been measured but has no design system yet. Ask me: "continue the import."'
+        : 'This repo has no design system contract yet. Ask me: "import my design system."';
+}
 /**
  * A CAUDA DE UM COMANDO QUE TERMINOU: o que ainda está fora, ou nada.
  *
  * Muda quando não falta nada, que é o caso normal e é o que a mantém legível. Ela existe porque
  * `sync`, `connect` e `upgrade` deixavam a pessoa sem saber se tinha acabado - e a resposta exigia
  * lembrar de um sexto comando (dono, 07/08).
+ *
+ * E QUANDO NÃO HÁ SISTEMA NENHUM ela dizia menos ainda: nada. O `connect` terminava mudo no único
+ * repo em que ele é a primeira coisa que alguém roda.
  */
 export async function reportWhatIsLeft(root, opts = {}) {
     const items = await misalignments(root, opts).catch(() => []);
-    if (items.length === 0)
+    if (items.length === 0) {
+        const next = await nextStepFor(root).catch(() => null);
+        if (next) {
+            console.log("");
+            console.log(body(next));
+        }
         return;
+    }
     console.log("");
     console.log(describeMisalignments(items, "after"));
 }
@@ -506,6 +544,21 @@ export async function align(opts) {
         ...(opts.cli ? { cli: opts.cli } : {}),
     });
     const text = describeMisalignments(items, opts.shell ? "shell" : "session");
-    if (text)
+    if (text) {
         console.log(text);
+        return;
+    }
+    /**
+     * A PRIMEIRA SESSÃO DEPOIS DO `connect` PASSA A TER UMA PRIMEIRA FRASE.
+     *
+     * Este é o hook `SessionStart`, e até aqui ele só falava de desalinho - então num repo sem
+     * sistema ele nunca falava. É onde a tese da landing vira experiência ou não vira nada: o agente
+     * abre sabendo o que falta, e quem está lendo descobre o que pedir sem ter guardado nada.
+     *
+     * Só quando há algo a dizer. O silêncio de um ambiente pronto é a razão de alguém ainda ler esta
+     * linha na vez em que ela aparece.
+     */
+    const next = await nextStepFor(root).catch(() => null);
+    if (next)
+        console.log(next);
 }

package/dist/commands/init.js

@@ -1,4 +1,6 @@
 import { DEFAULT_CONFIG, writeProjectConfig } from "../config.js";
+import { body, section, snippet } from "../output.js";
+import { wiringPrompt } from "../wiring-prompt.js";
 import { add } from "./add.js";
 /**
  * Bootstraps a project for SynthesisUI: writes `_synthesisui/config.json`
@@ -40,11 +42,37 @@ export async function init(opts) {
     // + rules + CLAUDE.md all arrive via `add`).
     if (opts.ds) {
         console.log("");
-        await add(opts.ds, { registry: opts.registry, dir: root });
-        // The layers exist and nothing installs them unless this is said out loud.
+        /**
+         * O FECHO DEIXA DE SER UMA LISTA DE TAREFAS (etapa 1.4 do plano).
+         *
+         * `add` imprime "One-time setup (once per app)" com três passos numerados
+         * para a PESSOA fazer à mão: os dois `@import`, o `data-ds` na raiz e a
+         * fiação das fontes. É onde 27/07 mediu 0% de fiação - ninguém fazia, e o
+         * sistema que acabara de chegar não aparecia na tela.
+         *
+         * Quem roda este comando tem um agente aberto do lado. Então o setup
+         * manual sai (`setupHints: false`) e no lugar dele vai a coisa que se
+         * cola - o mesmo texto que a tela do onboarding entrega, gêmeo por spec.
+         * As edições continuam existindo; elas só mudam de mão.
+         */
+        await add(opts.ds, {
+            registry: opts.registry,
+            dir: root,
+            setupHints: false,
+        });
+        console.log("");
+        console.log(section("Two steps left, and neither is a file you edit"));
+        console.log(body("1. Turn the check and the tools on - run this BEFORE you open your agent,"));
+        console.log(body("   because hooks and tools are read when a session starts:"));
+        console.log("");
+        console.log(snippet(["npx synthesisui@latest connect"]));
+        console.log("");
+        console.log(body("2. Open your agent and paste this once - it does the wiring:"));
+        console.log("");
+        console.log(snippet(wiringPrompt(opts.ds).split("\n")));
         console.log("");
-        console.log("  • synthesisui connect     so the check runs on its own, and your agent");
-        console.log("                            can ask this system instead of guessing");
+        console.log(body("Then ask it for something real. The check introduces itself on the first"));
+        console.log(body("clean file and goes quiet after that."));
         return;
     }
     console.log("");

package/dist/commands/login.js

@@ -1,6 +1,6 @@
 import { spawn } from "node:child_process";
 import { release } from "node:os";
-import { resolveRegistry, writeToken } from "../config.js";
+import { readCredentials, resolveRegistry, sameRegistry, writeToken, } from "../config.js";
 import { RegistryError } from "../registry.js";
 const CLIENT_ID = "synthesisui-cli";
 const GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
@@ -34,6 +34,29 @@ function openBrowser(url) {
 /** Device authorization (RFC 8628): opens the browser, waits for approval. */
 export async function login(opts) {
     const base = resolveRegistry(opts.registry);
+    /**
+     * O LOGIN QUE RECONHECE QUEM JÁ ENTROU (etapa 1.5 do plano, vazamento T1.6).
+     *
+     * Este comando abria um browser e pedia aprovação mesmo com um token válido
+     * na máquina, para o mesmo host. A install mission manda logar depois de a
+     * pessoa já ter logado no navegador, e o wizard manda logar no terminal - de
+     * modo que "faça de novo o que você acabou de fazer" era o caminho normal, e
+     * não um caso de borda. Pedir de novo o que já foi feito é a coisa que faz
+     * alguém desconfiar de que o produto sabe o que está acontecendo.
+     *
+     * Sai por aqui só quando o token é para ESTE host: um token de outro
+     * registry não serve, e reconhecê-lo seria um 401 mais tarde disfarçado de
+     * sucesso agora.
+     */
+    if (!opts.force) {
+        const existing = await readCredentials();
+        if (existing && sameRegistry(existing.registry, base)) {
+            console.log("");
+            console.log(`✓ Already signed in to ${base} on this machine.`);
+            console.log("  Run `synthesisui login --force` to sign in as someone else.");
+            return;
+        }
+    }
     const codeRes = await fetch(`${base}/api/auth/device/code`, {
         method: "POST",
         headers: { "content-type": "application/json" },

package/dist/index.js

@@ -36,7 +36,7 @@ const CLI_VERSION = JSON.parse(readFileSync(new URL("../package.json", import.me
 const HELP = `synthesisui - bring SynthesisUI design systems into your project
 
 Usage - deterministic, FREE:
-  synthesisui login [options]              connect the CLI to your account (device-flow)
+  synthesisui login [options]              connect the CLI to your account (device-flow; --force to switch accounts)
   synthesisui init [options]               write _synthesisui/config.json (target, dirs); --ds to bring one in
   synthesisui list [options]               list the published design systems
   synthesisui add <slug> [options]         materialize a DS into _synthesisui/ds/<slug>/
@@ -387,7 +387,10 @@ async function main() {
             break;
         }
         case "login":
-            await login({ registry });
+            // `--force` porque o comando agora sai cedo quando esta máquina já tem
+            // sessão para este host - trocar de conta continua possível, e passa a
+            // ser dito em vez de ser o comportamento padrão.
+            await login({ registry, force: args.includes("--force") });
             break;
         case "init": {
             const target = typeof flags.target === "string" ? flags.target : undefined;

package/dist/install-marks.js

@@ -89,7 +89,18 @@
  * "YOUR tokens, under YOUR names"). É a fatia de CLI da decisão de 16/08: toda superfície fala a
  * língua do cliente.
  */
-export const MATERIALISER_SINCE = "0.16.239";
+/**
+ * 0.16.239 -> 0.16.241 em 16/08, e é SIM: o arquivo que cai na pasta dele muda de CONDUTA, não de
+ * bytes decorativos. O stub de `sui-import-ds` respondia ao 401 do playbook com "run
+ * `npx synthesisui login` and call it again" - o que faz o agente parar a conversa e cobrar uma conta
+ * antes de mostrar um único número do repo dele. O `import --dry` nunca precisou de conta (ele
+ * retorna antes de ler credenciais), então o stub novo manda MEDIR primeiro, ler o censo de volta nos
+ * nomes dele, e só então pedir o login - e, para o MCP ausente, exigir sessão NOVA em vez de sugerir
+ * uma nova tentativa que não pode funcionar.
+ *
+ * Quem instalou antes desta versão tem o stub que estanca: o `upgrade`/`connect` é o que alcança.
+ */
+export const MATERIALISER_SINCE = "0.16.241";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/skill-import.js

@@ -12,4 +12,4 @@
  * invocada, e ela não é segredo - a esteira é.
  */
 export const IMPORT_SKILL_PATH = ".claude/skills/sui-import-ds/SKILL.md";
-export const IMPORT_SKILL = '---\nname: sui-import-ds\ndescription: Turn a codebase the user ALREADY has into a SynthesisUI design system. Use when someone points at an existing repo, app or component library and asks to import it, adopt it, bring it in, or "make a design system from this" (e.g. "/sui-import-ds", "importa o meu packages/ui", "turn this app into a design system"). Drives the full pipeline - measurement \u2192 your reading of the app \u2192 import \u2192 upgrade proposal - and answers the questions arithmetic cannot.\n---\n\n# Import Design System - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "import" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "import", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\nIf the tool answers that you are not signed in, run `npx synthesisui login`\nin the terminal and call it again. If the `synthesisui` MCP server is not\navailable at all, run `npx synthesisui connect`, restart the session, and\ninvoke this skill again.\n';
+export const IMPORT_SKILL = '---\nname: sui-import-ds\ndescription: Turn a codebase the user ALREADY has into a SynthesisUI design system. Use when someone points at an existing repo, app or component library and asks to import it, adopt it, bring it in, or "make a design system from this" (e.g. "/sui-import-ds", "importa o meu packages/ui", "turn this app into a design system"). Drives the full pipeline - measurement \u2192 your reading of the app \u2192 import \u2192 upgrade proposal - and answers the questions arithmetic cannot.\n---\n\n# Import Design System - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "import" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "import", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\n## If something is missing, they skipped a step - do not stall them\n\nThe supported order is `login`, then `connect`, then open this session. When\nit was followed, neither case below happens.\n\nNOT SIGNED IN. Do not stop and wait. Measure first, so they see their own\nrepo before being asked for anything:\n\n1. Run `npx synthesisui@latest import --dry` - it is local, free, needs no\n   account, and writes `_synthesisui/census.json`.\n2. Read that file and tell them what is in THEIR repo, in THEIR names: how\n   many declarations, how many components, how much already runs on tokens.\n3. Then: "to turn this into a system on your account, run\n   `npx synthesisui@latest login` and tell me when it is done."\n\nNO `synthesisui` MCP SERVER AT ALL. Tell them to run\n`npx synthesisui@latest connect` and then START A NEW SESSION - tools are read\nwhen a session opens, so this one cannot pick it up. Say it plainly and stop\nthere; carrying on in a session that cannot reach the playbook is guessing.\n';

package/dist/wiring-prompt.js

@@ -0,0 +1,34 @@
+/**
+ * O PASTE QUE TIRA AS QUATRO EDIÇÕES DA MÃO DA PESSOA.
+ *
+ * `init --ds` termina imprimindo uma seção "One-time setup" com três passos
+ * numerados para o humano fazer à mão: os dois `@import`, o `data-ds` na raiz
+ * e a fiação das fontes. Foi exatamente aí que 27/07 mediu 0% de fiação -
+ * ninguém fazia, e o sistema que acabara de chegar não aparecia na tela.
+ *
+ * A pessoa que roda esse comando tem um agente aberto ao lado. Então o fecho
+ * deixa de ser uma lista de tarefas e passa a ser uma coisa para colar.
+ *
+ * GÊMEO POR SPEC com `apps/web/src/lib/ds/install-mission.ts`, que serve o
+ * mesmo texto na tela do onboarding - `wiring-prompt.spec.ts` reprova o drift.
+ * O CLI é publicado standalone e não pode importar de `apps/web`, então a
+ * cópia é inevitável; o que não é inevitável é ela divergir em silêncio, e um
+ * prompt que diverge entre a tela e o terminal ensina duas fiações diferentes
+ * para o mesmo sistema.
+ */
+export function initCommand(slug) {
+    return `npx synthesisui@latest init --styles tailwind --ds ${slug}`;
+}
+export function wiringPrompt(slug) {
+    return `Wire the "${slug}" design system into this project. I already ran the install in my terminal.
+
+1. Run: npx synthesisui@latest doctor
+   If it says "no system installed", I skipped the install - run ${initCommand(slug)} first, then carry on.
+2. Do the ONE-TIME SETUP it names, all of it: the two @import lines in the project's global stylesheet (the path is relative to that file), data-ds="${slug}" on the root element, and the font wiring - importing from the fonts file it writes and mapping those variables in the stylesheet. The type is the step people skip.
+3. Run doctor again. It must NOT say "not wired up yet". If it does, it names exactly which piece is missing - fix that and run it again.
+4. Run: npx synthesisui@latest connect
+   If it answers "already had it" on both lines, everything is live and you are done.
+   If it WROTE either of them, then they are not live in this session, because hooks and tools are only read at startup. Stop there and tell me, in bold, on its own line: **RESTART THIS SESSION - the check is installed but not running yet.** Do not keep writing files after that; a session that cannot be checked is the state this whole setup exists to avoid.
+
+Do not change any of my existing styles.`;
+}

package/package.json

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