synthesisui 0.16.370 → 0.16.372

package/dist/commands/add.js

@@ -552,7 +552,25 @@ export async function add(slug, opts) {
      * saíram por serem nossos, com os primeiros nomes. Quem lê pode discordar de qualquer um.
      */
     if (aligned.dropped.length > 0) {
-        console.log(line(`  ${aligned.kept} Tailwind utilit${aligned.kept === 1 ? "y" : "ies"} now point at your own decisions; ${aligned.dropped.length} were left alone because the value would be ours (${aligned.dropped.slice(0, 3).join(", ")}${aligned.dropped.length > 3 ? ", …" : ""}) - your classes keep meaning what they mean today.`));
+        console.log(line(
+        /**
+         * A LINHA DIZ QUE FICARAM DE FORA - e nao AFIRMA por que, porque ela nao sabe.
+         *
+         * O DEFEITO, lido pelo dono na propria tela em 04/09: ela dizia *"left alone because THE
+         * VALUE WOULD BE OURS"* e listava `--background-image-gradient-grad-aurora`,
+         * `grad-cool`, `grad-fire` - os cinco gradientes DELE, que estao em `ownedNames.gradients`.
+         * A frase afirmava a origem do valor e errava.
+         *
+         * Sao TRES razoes diferentes e `onlyWhatMatched` so' distingue uma: o valor e' nosso · a
+         * familia nao tem como casar (gradiente nao esta' em `FAMILY_KIND`) · apontar criaria ciclo
+         * (a linha propria abaixo). Afirmar a primeira para as tres e' a mesma classe do aviso de
+         * aprovacao do MCP, que dizia "pendente" lendo duas listas vazias: uma frase que declara um
+         * estado que o codigo nao observou.
+         *
+         * Entao a linha diz o FATO que ela tem - a classe dele continua significando o que
+         * significa - e nomeia os primeiros, para quem quiser discordar de qualquer um.
+         */
+        `  ${aligned.kept} Tailwind utilit${aligned.kept === 1 ? "y" : "ies"} now point at your own decisions; ${aligned.dropped.length} were left as ${aligned.dropped.length === 1 ? "it is" : "they are"} (${aligned.dropped.slice(0, 3).join(", ")}${aligned.dropped.length > 3 ? ", …" : ""}) - your classes keep meaning what they mean today.`));
     }
     /**
      * O CICLO RECUSADO É DITO, e não engolido - senão o cliente lê um número menor sem saber por quê.

package/dist/commands/align.js

@@ -94,7 +94,7 @@ export async function localMisalignments(root,
  * máquina que roda o teste não é verificável: ela passa ou falha conforme quem está logado ali.
  */
 opts = {}) {
-    const { cli, home = homedir() } = opts;
+    const { cli, home = homedir(), justMeasured = 0 } = opts;
     const out = [];
     const locks = (await locksIn(root)).filter((l) => l.slug && !l.adopted);
     /** Sem sistema instalado não há alinho a cobrar - não é desalinho, é um repo sem DS. */
@@ -214,11 +214,27 @@ opts = {}) {
      * número só crescia.
      */
     const events = await unsentEvents(root).catch(() => []);
-    if (events.length > 0)
+    if (events.length > 0) {
+        /**
+         * O QUE ESTA RODADA MEDIU NÃO É EVIDÊNCIA VELHA - ver `justMeasured`.
+         *
+         * "the platform is scoring this repo on older evidence" é verdade quando o registro esperava
+         * desde ontem, e é enganoso quando a leitura tem três segundos e foi este comando que a fez. As
+         * duas frases pedem o MESMO `sync`, de propósito: o registro só sai da máquina quando a pessoa
+         * manda, e nada aqui desconta um evento que realmente não subiu. O que muda é o que a linha
+         * ensina - consequência do que ela acabou de fazer, em vez de dívida que ela deixou acumular.
+         *
+         * SÓ QUANDO TODOS OS PENDENTES VIERAM DAQUI. Com cinco esperando de antes e um novo, há
+         * evidência velha de verdade, e a frase de sempre é a honesta.
+         */
+        const allFromThisRun = justMeasured > 0 && justMeasured >= events.length;
         out.push({
-            says: `${events.length} checked write${events.length === 1 ? "" : "s"} recorded here and not sent - the platform is scoring this repo on older evidence.`,
+            says: allFromThisRun
+                ? "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",
         });
+    }
     /**
      * O DÉCIMO ESTADO: os ARQUIVOS deste install foram escritos por um CLI anterior.
      *
@@ -597,6 +613,8 @@ opts = {}) {
     const items = await localMisalignments(root, {
         ...(opts.cli ? { cli: opts.cli } : {}),
         ...(opts.home ? { home: opts.home } : {}),
+        /** ATRAVESSA - ver `home` acima: uma porta que não repassa é a regressão da 0.16.365 de novo. */
+        ...(opts.justMeasured ? { justMeasured: opts.justMeasured } : {}),
     }).catch(() => []);
     /** A única linha que custa rede, e ela some inteira quando não há rede. */
     const remote = await versionBehind(root, {

package/dist/commands/upgrade.js

@@ -4,6 +4,7 @@ import { pinnedHookVersion, wireAgent } from "../agent-wiring.js";
 import { isOlderCli } from "../cli-version.js";
 import { generateComponentFiles } from "../component-codegen.js";
 import { readProjectConfig, readToken, resolveRegistry } from "../config.js";
+import { unsentEvents } from "../doctor/ledger.js";
 import { diffLocalDocuments, localChangelogMarkdown, } from "../document-diff.js";
 import { installedBehind, MATERIALISER_SINCE } from "../install-marks.js";
 import { body, section, snippet } from "../output.js";
@@ -174,12 +175,30 @@ async function rewireIfBehind(root, cli) {
  * NUNCA `strict`. Um achado é informação, não falha do upgrade, e sair com erro por causa do drift da
  * própria pessoa transformaria uma instalação bem-sucedida num terminal vermelho.
  */
+/**
+ * DEVOLVE QUANTAS MEDIÇÕES ESTA CHAMADA DEIXOU PARA TRÁS, e é isso que impede o comando de cobrar
+ * de si mesmo.
+ *
+ * O `upgrade` termina imprimindo o que ainda falta, e o que faltava incluía o registro que ELE
+ * acabou de gravar aqui: quem rodava `sync` e em seguida `upgrade` via a tela pedir `sync` de novo e
+ * concluía que o primeiro não tinha adiantado. A lista continua pedindo o envio - o registro só sai
+ * da máquina quando a pessoa manda, e isso não se contorna -, mas passa a dizer que a leitura é
+ * desta rodada em vez de chamá-la de evidência velha. Ver `justMeasured` em `align.ts`.
+ *
+ * LIDO DO DISCO, antes e depois. O doctor grava em três pontos diferentes e nenhum deles reporta
+ * quantos; contar os não enviados nos dois instantes responde a pergunta sem que nenhuma das três
+ * chamadas precise concordar com esta. É o mesmo instrumento que o spec da re-materialização usa,
+ * e pela mesma razão: o ledger não tem como concordar por engano.
+ */
 async function checkAfterWriting(root, version) {
+    const before = await unsentEvents(root).catch(() => []);
     console.log(section(`Checking the app against ${version}`));
     await doctor({ dir: root }).catch((err) => {
         /** Um doctor que não roda não é um upgrade que falhou: os artefatos já estão em disco e certos. */
         console.log(body(`The check could not run (${err instanceof Error ? err.message : "unknown"}). Run \`npx synthesisui doctor\` when you can.`));
     });
+    const after = await unsentEvents(root).catch(() => []);
+    return Math.max(0, after.length - before.length);
 }
 async function theOnlyInstalled(root) {
     const dsDir = join(root, "_synthesisui", "ds");
@@ -242,8 +261,11 @@ export async function upgrade(asked, opts) {
              * `sync` seguinte respondeu `6 checks sent, 0 new` - o comando disse que atualizou e nada foi
              * medido.
              */
-            await checkAfterWriting(root, `v${installed}`);
-            await reportWhatIsLeft(root, opts.cli ? { cli: opts.cli } : {});
+            const measured = await checkAfterWriting(root, `v${installed}`);
+            await reportWhatIsLeft(root, {
+                ...(opts.cli ? { cli: opts.cli } : {}),
+                ...(measured > 0 ? { justMeasured: measured } : {}),
+            });
             return;
         }
         if (!opts.force) {
@@ -430,7 +452,7 @@ export async function upgrade(asked, opts) {
         for (const k of kept)
             console.log(body(keptLine(slug, k.entry, k.edited)));
     }
-    await checkAfterWriting(root, `v${latest.version}`);
+    const measured = await checkAfterWriting(root, `v${latest.version}`);
     console.log(section("Migrate the app"));
     console.log(body(`The migration brief is at _synthesisui/ds/${slug}/UPGRADE.md`));
     console.log("");
@@ -441,6 +463,9 @@ export async function upgrade(asked, opts) {
     ]));
     console.log("");
     console.log(body(`(rollback: synthesisui add ${slug} --version ${installed})`));
-    await reportWhatIsLeft(root, opts.cli ? { cli: opts.cli } : {});
+    await reportWhatIsLeft(root, {
+        ...(opts.cli ? { cli: opts.cli } : {}),
+        ...(measured > 0 ? { justMeasured: measured } : {}),
+    });
     console.log("");
 }

package/package.json

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