synthesisui 0.16.384 → 0.16.385

package/dist/commands/align.js

@@ -278,6 +278,8 @@ opts = {}) {
                 ? "This run measured the app, and that reading is still on this machine - the platform keeps scoring the previous one until you send it."
                 : `${events.length} checked write${events.length === 1 ? "" : "s"} recorded here and not sent - the platform is scoring this repo on older evidence.`,
             run: "npx synthesisui sync",
+            /** Ver `Misalignment.fromThisRun`: o cabeçalho lê daqui, e não reimplementa a pergunta. */
+            fromThisRun: allFromThisRun,
         });
     }
     /**
@@ -570,12 +572,33 @@ export function describeMisalignments(items,
 from = "session") {
     if (items.length === 0)
         return "";
+    /**
+     * "STILL OUT OF ALIGNMENT" SOBRE O QUE O PRÓPRIO COMANDO ACABOU DE PRODUZIR - achado do dono em
+     * 06/09, e ele o descreveu na hora: *"depois do upgrade (pediu o sync novamente)"*.
+     *
+     * O QUE ELE VIU: o `sync` disse que as regras mudaram e mandou rodar `upgrade`. O `upgrade`
+     * materializou, MEDIU o app - e a medição nova é evidência que ainda não subiu -, então fechou
+     * dizendo "Still out of alignment" e mandou rodar `sync`. Dois comandos apontando um para o
+     * outro, com um cabeçalho que afirma que algo continua errado.
+     *
+     * NÃO É LOOP: o segundo `sync` fecha, porque o que falta é enviar o que este `upgrade` acabou de
+     * medir. Mas isso não está em lugar nenhum da tela, e quem lê não tem como distinguir progresso
+     * de giro - a diferença entre as duas é a única coisa que decide se ele roda de novo ou desiste.
+     *
+     * A INFORMAÇÃO JÁ EXISTIA UMA LINHA ABAIXO. `allFromThisRun` distingue "havia evidência velha
+     * parada aqui" de "esta execução acabou de medir", e a frase do item já diz *"This run measured
+     * the app"*. Só o CABEÇALHO tratava os dois casos como o mesmo. Quando todo achado é consequência
+     * desta execução, ele passa a dizer o que a próxima linha resolve - e não que algo falhou.
+     */
+    const consequencia = from === "after" && items.every((i) => i.fromThisRun === true);
     return [
-        from === "after"
-            ? "Still out of alignment:"
-            : from === "shell"
-                ? "This repo is out of alignment with the design system that governs it:"
-                : "Before this session starts, this environment is out of alignment with the design system that governs it:",
+        consequencia
+            ? "One step left, and it closes what this run produced:"
+            : from === "after"
+                ? "Still out of alignment:"
+                : from === "shell"
+                    ? "This repo is out of alignment with the design system that governs it:"
+                    : "Before this session starts, this environment is out of alignment with the design system that governs it:",
         ...grouped(items),
     ].join("\n");
 }

package/dist/commands/doctor.js

@@ -22,6 +22,7 @@ import { actingSlug, describeScope, measuredScope, scopePaths, } from "../measur
 import { body, paint, section, snippet } from "../output.js";
 import { resolveDeps } from "../stack.js";
 import { danglingTheirVars } from "../their-vars.js";
+import { wiringPrompt } from "../wiring-prompt.js";
 /**
  * `synthesisui doctor` - the check nobody else ships.
  *
@@ -995,7 +996,29 @@ export async function doctor(opts) {
             console.log(body("are declared and nothing points at them, so the page renders in"));
             console.log(body("whatever the framework picked."));
         }
-        console.log(body("The exact snippets are in the output of `init`."));
+        /**
+         * A FIAÇÃO SAI DAQUI, e não de outro comando - achado do dono em 06/09, rodando o `upgrade`.
+         *
+         * O QUE ELE VIU: o doctor diz `installed - but not wired up yet` e *"none of the 66 tokens
+         * reach the browser"*, e a linha seguinte mandava ler *"the output of `init`"*. `init` é o
+         * comando de PRIMEIRA VEZ - ele instala um sistema em quem não tem nenhum. Quem chegou até
+         * aqui já importou, materializou e rodou upgrade: mandá-lo ao `init` é devolver ao começo
+         * alguém que está a um passo do fim.
+         *
+         * E O PASSO JÁ EXISTIA PRONTO. `wiringPrompt` mora em `wiring-prompt.ts`, exportado, e era
+         * usado só pelo `init`. Imprimi-lo aqui não é texto novo: é a MESMA fonte chegando na tela
+         * onde a pergunta nasce. Duas redações do mesmo passo divergiriam no primeiro conserto.
+         *
+         * O PROMPT E NÃO O SNIPPET, porque o caminho do `@import` é relativo à folha global DELE e
+         * ninguém aqui sabe onde ela está. O prompt manda o agente rodar o doctor, ler o que ele
+         * nomeia e fazer - que é o que funciona em projeto arbitrário.
+         */
+        if (table.slug) {
+            console.log("");
+            console.log(body("Paste this into your agent - it does the wiring:"));
+            console.log("");
+            console.log(snippet(wiringPrompt(table.slug).split("\n")));
+        }
     }
     /**
      * A FOLHA APONTA PARA O VOCABULÁRIO DELE, E UM NOME SUMIU - ver `their-vars.ts`.

package/package.json

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