synthesisui 0.16.241 → 0.16.243

package/dist/commands/align.js

@@ -5,8 +5,10 @@ import { pinnedHookVersion } from "../agent-wiring.js";
 import { isOlderCli } from "../cli-version.js";
 import { readToken, resolveRegistry } from "../config.js";
 import { unsentEvents } from "../doctor/ledger.js";
+import { readRequests } from "../doctor/requests.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.
@@ -313,6 +315,32 @@ export function repairSaid(body, lock) {
         then: "claude --continue --dangerously-skip-permissions",
     };
 }
+/**
+ * QUANTAS RESPOSTAS ESTÃO ESPERANDO PARA SEREM BUSCADAS - o cruzamento das duas listas.
+ *
+ * A plataforma manda os ids que ela já decidiu; o arquivo local diz o que ainda está aberto AQUI.
+ * A interseção é a notícia: pedidos que foram respondidos e cuja resposta esta máquina nunca viu.
+ *
+ * `null` quando não há nada, quando o arquivo não existe, ou quando a plataforma é velha demais para
+ * mandar o campo - um CLI novo contra um servidor antigo fica exatamente como estava, calado.
+ */
+async function decidedWaiting(root, decided) {
+    if (!decided || decided.length === 0)
+        return null;
+    const open = await readRequests(root).catch(() => []);
+    if (open.length === 0)
+        return null;
+    const answered = new Set(decided);
+    const n = open.filter((r) => answered.has(r.id)).length;
+    if (n === 0)
+        return null;
+    return {
+        says: n === 1
+            ? "A request you filed has been answered on the platform, and this machine has not picked it up yet."
+            : `${n} requests you filed have been answered on the platform, and this machine has not picked them up yet.`,
+        run: "npx synthesisui sync",
+    };
+}
 export async function versionBehind(root, opts = {}) {
     const locks = (await locksIn(root)).filter((l) => l.slug && !l.adopted);
     const lock = locks[0];
@@ -350,6 +378,24 @@ export async function versionBehind(root, opts = {}) {
      * a versão é a consequência - dizer a consequência primeiro manda a pessoa rodar o comando sem
      * saber por quê.
      */
+    /**
+     * ALGUÉM JÁ RESPONDEU UM PEDIDO SEU, E VOCÊ NÃO TEM COMO SABER.
+     *
+     * O agente arquiva a lacuna, a pessoa decide na plataforma - e a decisão fica lá. O arquivo local
+     * nunca é tocado por design: o próximo `sync` lê o status, fecha o pedido na máquina e imprime o
+     * próximo passo. O buraco está no "próximo": até alguém rodar o comando, uma resposta dada há dias
+     * não existe deste lado, e quem esperava por ela descobre por acaso.
+     *
+     * O cruzamento tem que ser AQUI, e é por isso que a plataforma manda ids em vez de uma frase: só
+     * esta máquina sabe o que ainda está ABERTO na fila local. Um pedido decidido que já foi fechado
+     * aqui não é notícia, e contá-lo faria o hook cobrar para sempre um trabalho já feito.
+     *
+     * Vem antes da versão e do reparo porque é a única linha desta lista sobre uma pergunta que a
+     * PESSOA fez - e uma resposta que ela pediu vale mais que uma novidade que ela não pediu.
+     */
+    const waiting = await decidedWaiting(root, body.decided);
+    if (waiting)
+        return waiting;
     const repaired = repairSaid(body, lock);
     if (repaired)
         return repaired;
@@ -486,17 +532,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 +589,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/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.241",
+  "version": "0.16.243",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {