synthesisui 0.16.210 → 0.16.212

package/dist/commands/align.js

@@ -5,7 +5,7 @@ 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 { CHECKER_SINCE, MATERIALISER_SINCE, READER_SINCE, } from "../install-marks.js";
+import { CHECKER_SINCE, installedBehind, MATERIALISER_SINCE, READER_SINCE, } from "../install-marks.js";
 import { measuredScope } from "../measured-scope.js";
 /**
  * QUAL CLI MEDIU O CENSO EM DISCO - e era o `reader`, um inteiro, até 11/08.
@@ -81,13 +81,7 @@ async function credentials(home) {
  * nada com `upgrade` - o comando usa o CLI que ela tem. Mandar rodar ali é gastar a atenção dela num
  * comando que não pode mudar nada, e o caminho de verdade é outro (`connect`).
  */
-function behind(installed, running, since) {
-    if (!installed || !running)
-        return null;
-    if (!isOlderCli(installed, since))
-        return null;
-    return isOlderCli(running, since) ? null : installed;
-}
+const behind = (installed, running, since) => installedBehind(installed, running, since, isOlderCli);
 export async function localMisalignments(root, 
 /**
  * `home` é injetável porque a SESSÃO mora nele e não no repo - e uma verificação que lê o home da

package/dist/commands/sync.js

@@ -363,6 +363,8 @@ export async function remeasure(args) {
             ?.declarations ?? 0,
         seen: sum(led?.counted),
         interpreted: sum(led?.interpreted),
+        /** O que não foi lido, por MOTIVO - ver `unread` em `SyncMark`. */
+        unread: Object.fromEntries((led?.unread ?? []).map((g) => [g.reason ?? "unknown", g.uses ?? 0])),
         /** O que cada componente LÊ - ver `readings` em `SyncMark`, e o defeito que ele conserta. */
         ...(args.cli ? { cli: args.cli } : {}),
         readings: fingerprintReadings(census.components),

package/dist/commands/upgrade.js

@@ -1,9 +1,11 @@
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { pinnedHookVersion, wireAgent } from "../agent-wiring.js";
+import { isOlderCli } from "../cli-version.js";
 import { generateComponentFiles } from "../component-codegen.js";
 import { readProjectConfig, resolveRegistry } from "../config.js";
 import { diffLocalDocuments, localChangelogMarkdown, } from "../document-diff.js";
+import { installedBehind, MATERIALISER_SINCE } from "../install-marks.js";
 import { body, section, snippet } from "../output.js";
 import { reactMajorOf, readInstalledConvention } from "../project-facts.js";
 import { fetchChangelog, fetchComponent, fetchDesignSystem, RegistryError, } from "../registry.js";
@@ -112,8 +114,17 @@ async function staleInstall(root, slug, version, base, cli) {
         why.push("the css is compiled differently now");
     if (meta?.rulesStamp != null && meta.rulesStamp !== (lock.rules ?? null))
         why.push("the rules that govern it changed");
-    if (cli && lock.cli && lock.cli !== cli)
-        why.push(`these files were written by CLI ${lock.cli}`);
+    /**
+     * COMPARA `MATERIALISER_SINCE`, e não a string da versão - a mesma correção que o `align` recebeu.
+     *
+     * O dono rodou `upgrade` em 11/08 e leu *"these files were written by CLI 0.16.210 -
+     * re-materializing"* com a marca em 0.16.204: o comando reescrevia, e ANUNCIAVA reescrever,
+     * arquivos que sairiam byte a byte iguais. Consertar o alarme e deixar o comando é dizer duas
+     * coisas sobre um fato só.
+     */
+    const staleFiles = installedBehind(lock.cli, cli, MATERIALISER_SINCE, isOlderCli);
+    if (staleFiles)
+        why.push(`these files were written by CLI ${staleFiles}`);
     return why.length > 0 ? `${why.join(", ")} - re-materializing` : null;
 }
 /**

package/dist/install-marks.js

@@ -101,3 +101,28 @@ export const CHECKER_SINCE = "0.16.202";
  * Um censo medido antes disto carrega as duas leituras erradas.
  */
 export const READER_SINCE = "0.16.210";
+/**
+ * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
+ *
+ * `installed` é a versão que escreveu a coisa; `running` é o CLI de hoje; `since` é a última versão
+ * em que aquilo mudou de verdade. Nenhuma das duas basta sozinha:
+ *
+ *     o que está instalado é ANTERIOR à última mudança    senão reescreve bytes idênticos
+ *     o CLI de hoje já ALCANÇOU essa mudança              senão escreve a mesma coisa velha
+ *
+ * Nasceu privado dentro do `align` e virou exportado quando o dono rodou `upgrade` em 11/08 e leu
+ * *"these files were written by CLI 0.16.210 - re-materializing"* com `MATERIALISER_SINCE` em
+ * 0.16.204: o comando ainda comparava a STRING da versão, então ele anunciava reescrever arquivos
+ * que sairiam byte a byte iguais. Consertar o alarme e deixar o comando é dizer duas coisas sobre
+ * um fato só.
+ *
+ * `isOlder` entra por parâmetro para este módulo continuar sem import nenhum - ele é lido pelo spec
+ * gêmeo da plataforma como TEXTO, e uma dependência aqui é uma dependência lá.
+ */
+export function installedBehind(installed, running, since, isOlder) {
+    if (!installed || !running)
+        return null;
+    if (!isOlder(installed, since))
+        return null;
+    return isOlder(running, since) ? null : installed;
+}

package/dist/last-sync.js

@@ -66,6 +66,29 @@ export async function writeSyncMark(root, mark) {
  * parecer um salto enorme. E quando nada mudou ela DIZ que nada mudou: é a resposta mais útil que uma
  * re-medição pode dar, e é a que o relatório longo nunca conseguiu dar em seis execuções.
  */
+/**
+ * OS MOTIVOS QUE MUDARAM DE TAMANHO, nomeados - ver `unread` em `SyncMark`.
+ *
+ * `undefined` de um lado é marca anterior a este campo, e ali silêncio é a resposta: comparar contra
+ * ausência produziria "tudo é novo" na primeira vez, para todo mundo.
+ */
+function unreadDelta(now, before) {
+    if (!now.unread || !before.unread)
+        return null;
+    const keys = [
+        ...new Set([...Object.keys(before.unread), ...Object.keys(now.unread)]),
+    ].sort();
+    const moved = keys
+        .map((k) => ({
+        k,
+        from: before.unread?.[k] ?? 0,
+        to: now.unread?.[k] ?? 0,
+    }))
+        .filter((m) => m.from !== m.to);
+    if (moved.length === 0)
+        return null;
+    return moved.map((m) => `${m.k} ${m.from} → ${m.to}`).join(", ");
+}
 export function describeDelta(now, before) {
     if (!before)
         return "first measurement recorded here - the next one compares against it";
@@ -89,6 +112,10 @@ export function describeDelta(now, before) {
     const read = readingDelta(now, before);
     if (read)
         parts.push(read);
+    /** E o que não foi lido, por motivo - ver `unread` em `SyncMark`. */
+    const reasons = unreadDelta(now, before);
+    if (reasons)
+        parts.push(reasons);
     const when = ago(before.at);
     /**
      * O INSTRUMENTO ANDOU, e isso vem junto do número em vez de depois dele. Ver `cli`.

package/package.json

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