synthesisui 0.16.185 → 0.16.187

package/dist/commands/upgrade.js

@@ -137,6 +137,28 @@ async function rewireIfBehind(root, cli) {
     console.log(`↻ the check after every write moved from ${pinned} to ${cli}`);
     console.log("  Reopen your editor session - hooks are read at startup.");
 }
+/**
+ * O RECIBO DO PRÓPRIO UPGRADE - e há UM lugar que o emite, para os dois caminhos de escrita.
+ *
+ * Um upgrade que entrega arquivos novos e depois pede para alguém lembrar de conferir deixa a pessoa
+ * sem saber se funcionou (dono, 01/08). Então a checagem roda daqui, sobre a mesma raiz, e o
+ * relatório dela é o recibo.
+ *
+ * ELE VIROU UMA FUNÇÃO SÓ em 08/08 porque a duplicata custou caro: a chamada morava no fim do
+ * caminho de troca de VERSÃO, e o caminho de rematerialização - o comum, o que o alerta do terminal
+ * aciona - saía antes por um `return`. Os dois números do alerta fechavam e a medição continuava
+ * parada. Um spec textual passava, porque a chamada existia; ela é que não era alcançada.
+ *
+ * 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.
+ */
+async function checkAfterWriting(root, version) {
+    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.`));
+    });
+}
 async function theOnlyInstalled(root) {
     const dsDir = join(root, "_synthesisui", "ds");
     const entries = await readdir(dsDir, { withFileTypes: true }).catch(() => []);
@@ -188,6 +210,17 @@ export async function upgrade(asked, opts) {
                 ...(opts.cli ? { cli: opts.cli } : {}),
             });
             await rewireIfBehind(root, opts.cli);
+            /**
+             * E ESTE CAMINHO MEDE TAMBÉM - ele não media, e é justamente o que o alerta do terminal manda
+             * rodar (dono, 08/08).
+             *
+             * A rematerialização é o caso comum agora: a versão do DS não mudou, mudou o LEITOR. Só que
+             * ela saía por este `return` antes de chegar ao doctor lá embaixo, então a pessoa via os dois
+             * números do alerta fecharem e a medição continuar sendo a de dias atrás. Na máquina do dono o
+             * `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 } : {});
             return;
         }
@@ -326,26 +359,7 @@ export async function upgrade(asked, opts) {
         console.log("");
         console.log(body(`⚠ Could not regenerate: ${failed.join(", ")} (removed/renamed in v${latest.version}?)`));
     }
-    /**
-     * THE CHECK RUNS ITSELF - closing the loop the owner asked for end to end
-     * (dono, 01/08).
-     *
-     * An upgrade that lands a v2 whose whole point is "these literals are tokens
-     * now" and then says "ask your agent to migrate" leaves the person with no
-     * way to know whether it worked. The doctor is the answer and it is one
-     * command, so it is not somebody's job to remember: it runs here, over the
-     * same root, and its report IS the receipt.
-     *
-     * Never strict. A finding is information, not a failure of the upgrade, and
-     * exiting non-zero on somebody's own drift would turn a successful install
-     * into a red terminal.
-     */
-    console.log(section("Checking the app against v" + latest.version));
-    await doctor({ dir: root }).catch((err) => {
-        // A doctor that cannot run is not an upgrade that failed - the artifacts
-        // are already on disk and correct.
-        console.log(body(`The check could not run (${err instanceof Error ? err.message : "unknown"}). Run \`npx synthesisui doctor\` when you can.`));
-    });
+    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("");

package/dist/progress.js

@@ -14,6 +14,19 @@
  * writes a carriage return into a transcript.
  */
 const BAR_WIDTH = 24;
+/**
+ * O INTERVALO MÍNIMO ENTRE DOIS QUADROS - e ele existe por causa do CLIPBOARD, não da velocidade.
+ *
+ * A linha se redesenha com `\r`, então na tela ela é UMA linha e a leitura é ótima. Copiar é outra
+ * história: o `\r` não sobrevive à seleção, então cada repintura vira um pedaço do texto colado. Em
+ * 08/08 o dono tentou copiar a saída de um `sync` e levou junto 2 172 quadros - um por arquivo de
+ * evidência -, o que enterrou o relatório que ele queria mostrar (dono, 08/08).
+ *
+ * 80ms é o teto do que um olho aproveita: acima de ~12 quadros por segundo a animação já lê como
+ * contínua, e o resto é trabalho que só o clipboard vê. No caso dele isso troca 2 172 quadros por
+ * algumas dezenas, sem tirar um único frame que alguém fosse perceber.
+ */
+const MIN_FRAME_MS = 80;
 /** Every this-many items, the non-TTY path prints one line. Enough to see movement in
  *  a piped log without turning it into the log. */
 const MILESTONE_EVERY = 25;
@@ -49,9 +62,12 @@ function tail(label, width) {
 export function startProgress(title, opts) {
     const write = opts?.write ?? ((s) => process.stdout.write(s));
     const tty = opts?.isTty ?? Boolean(process.stdout.isTTY);
+    const now = opts?.now ?? (() => Date.now());
     let total = opts?.total ?? 0;
     let done = 0;
     let last = "";
+    /** `-Infinity` para o PRIMEIRO passo pintar sempre: silêncio no começo lê como travado. */
+    let painted = Number.NEGATIVE_INFINITY;
     const paint = () => {
         const count = total > 0 ? `${done} of ${total}` : String(done);
         const line = `  ${bar(done, total)}  ${count}  ${tail(last, 40)}`;
@@ -64,6 +80,14 @@ export function startProgress(title, opts) {
             done += 1;
             last = label;
             if (tty) {
+                /**
+                 * O ÚLTIMO SEMPRE PINTA, mesmo dentro da janela: parar num "2 100 de 2 172" e pular para o
+                 * resumo faria a barra parecer que desistiu antes do fim.
+                 */
+                const at = now();
+                if (at - painted < MIN_FRAME_MS && !(total > 0 && done === total))
+                    return;
+                painted = at;
                 paint();
                 return;
             }

package/package.json

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