synthesisui 0.16.383 → 0.16.385

package/dist/baseline-craft.js

@@ -27,9 +27,30 @@ export function craftLines(craft) {
     if (craft.score === null) {
         return bodyWrapped("No component of yours was read yet, so there is no line to draw. Your tokens came through - the components are next.").map(body);
     }
-    const lines = [
-        body(`${paint.strong(`${craft.score}/100`)} on your ${craft.authored} component${craft.authored === 1 ? "" : "s"} - never on our kit, never on a demo.`),
-    ];
+    /**
+     * O DENOMINADOR EM PALAVRAS, e ele existe para a nota não subir calada.
+     *
+     * Um componente sem receita nenhuma sai da média desde 06/09 - ninguém o escreveu ainda, e
+     * contá-lo como zero afirma que o código dele é ruim onde não há código. Mas uma nota que
+     * melhora sem explicação lê como régua afrouxada, então a frase diz sobre QUANTOS ela foi
+     * tirada.
+     *
+     * SÓ QUANDO EXISTE, e `unwritten` ausente é diferente de zero: um servidor anterior a esta
+     * versão não manda o campo, e afirmar "todos têm receita" ali seria inventar.
+     */
+    const plural = craft.authored === 1 ? "" : "s";
+    const written = craft.unwritten === undefined ? null : craft.authored - craft.unwritten;
+    const apart = written !== null && craft.unwritten ? craft.unwritten : 0;
+    const lines = bodyWrapped(`${paint.strong(`${craft.score}/100`)} on ${apart ? `${written} of your ${craft.authored}` : `your ${craft.authored}`} component${plural} - never on our kit, never on a demo.`).map(body);
+    /**
+     * A LINHA PRÓPRIA, e não uma oração dentro da primeira.
+     *
+     * Escrita junto, a frase ocupava três linhas no terminal e o fato principal - a nota - ficava
+     * enterrado no meio da ressalva. A nota é o que ele veio ver; por que ela é sobre 49 e não 62 é
+     * a segunda pergunta, e ela merece a segunda linha.
+     */
+    if (apart)
+        lines.push(...bodyWrapped(`${apart} have no recipe yet: counted apart, never against you.`).map((l) => body(paint.dim(l))));
     /**
      * OS RÓTULOS ALINHADOS PELO MAIS LONGO, e a largura é medida e não estimada: os nomes chegam do
      * servidor, então um padding fixo desalinharia no dia em que uma lente for renomeada lá.

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.383",
+  "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": {