synthesisui 0.16.200 → 0.16.201

package/dist/commands/sync.js

@@ -4,7 +4,7 @@ import { isOlderCli } from "../cli-version.js";
 import { readToken, resolveRegistry } from "../config.js";
 import { markSent, readEvents } from "../doctor/ledger.js";
 import { checkableName, closeRequest, readRequests, verifyAndCloseRequests, } from "../doctor/requests.js";
-import { describeDelta, readSyncMark, writeSyncMark, } from "../last-sync.js";
+import { describeDelta, fingerprintReadings, readSyncMark, writeSyncMark, } from "../last-sync.js";
 import { measuredScope, rememberScope } from "../measured-scope.js";
 import { body, paint, section, snippet } from "../output.js";
 import { repoStateOf } from "../repo-state.js";
@@ -363,6 +363,9 @@ export async function remeasure(args) {
             ?.declarations ?? 0,
         seen: sum(led?.counted),
         interpreted: sum(led?.interpreted),
+        /** O que cada componente LÊ - ver `readings` em `SyncMark`, e o defeito que ele conserta. */
+        ...(args.cli ? { cli: args.cli } : {}),
+        readings: fingerprintReadings(census.components),
     };
     console.log(body(paint.faint(describeDelta(mark, await readSyncMark(root)))));
     await writeSyncMark(root, mark);

package/dist/last-sync.js

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 /**
@@ -13,6 +14,30 @@ import { join } from "node:path";
  * "antes" - e diz isso, em vez de inventar um delta.
  */
 export const LAST_SYNC_FILE = ".last-sync.json";
+/**
+ * A IMPRESSÃO DA LINHA INTEIRA, e nunca de campos escolhidos a dedo.
+ *
+ * A tentação é hashear `props` e `count`. A lição deste repositório é que uma lista de campos
+ * escrita hoje esquece o campo de amanhã, em silêncio: `origin` nasceu em 10/08 e uma impressão
+ * seletiva não o veria. Serializar a linha com as chaves ordenadas custa nada e não tem como
+ * envelhecer.
+ *
+ * `name` sai do valor porque já É a chave - hasheá-lo junto só gastaria bytes.
+ */
+export function fingerprintReadings(components) {
+    const out = {};
+    for (const c of components ?? []) {
+        const name = typeof c?.name === "string" ? c.name : null;
+        if (!name)
+            continue;
+        const { name: _drop, ...rest } = c;
+        out[name] = createHash("sha256")
+            .update(JSON.stringify(rest, Object.keys(rest).sort()))
+            .digest("hex")
+            .slice(0, 12);
+    }
+    return out;
+}
 const path = (root) => join(root, "_synthesisui", LAST_SYNC_FILE);
 export async function readSyncMark(root) {
     try {
@@ -47,11 +72,57 @@ export function describeDelta(now, before) {
     moved("declarations", before.declarations, now.declarations);
     moved("fragments read", before.interpreted, now.interpreted);
     moved("fragments seen", before.seen, now.seen);
+    /**
+     * E O QUE MUDOU DE LEITURA, que é o que um conserto de leitor move. Ver `readings`.
+     *
+     * Nomeados, e não só contados: "4 components read differently" manda a pessoa procurar; com os
+     * nomes ela abre os quatro. O corte em três é o mesmo critério do resto da esteira - alguns
+     * mostram a forma, o resto vira contagem.
+     */
+    const read = readingDelta(now, before);
+    if (read)
+        parts.push(read);
     const when = ago(before.at);
-    return parts.length === 0
-        ? `nothing moved since your last sync${when ? `, ${when}` : ""}`
-        : `${parts.join(" · ")} — since your last sync${when ? `, ${when}` : ""}`;
+    /**
+     * O INSTRUMENTO ANDOU, e isso vem junto do número em vez de depois dele. Ver `cli`.
+     */
+    const reader = before.cli && now.cli && before.cli !== now.cli
+        ? `, and the reader moved ${before.cli} → ${now.cli}, so some of this is us reading better rather than your code changing`
+        : "";
+    if (parts.length > 0)
+        return `${parts.join(" · ")} — since your last sync${when ? `, ${when}` : ""}${reader}`;
+    /**
+     * NADA MUDOU É DIFERENTE DE NÃO DÁ PARA SABER. Um carimbo de uma versão anterior a esta não tem
+     * as impressões, então afirmar que nada mudou seria afirmar sobre o que não foi medido - e é
+     * justamente a rodada que ESTREIA um leitor novo que cairia nesse silêncio.
+     */
+    if (!before.readings)
+        return `the four totals are unchanged since your last sync${when ? `, ${when}` : ""} - what each component reads was not recorded back then, so this run has nothing to compare it against. The next one will.`;
+    return `nothing moved since your last sync${when ? `, ${when}` : ""}`;
+}
+/** Quantos componentes leem diferente, e quais - ou nada, quando não há o que comparar. */
+function readingDelta(now, before) {
+    const was = before.readings;
+    const is = now.readings;
+    if (!was || !is)
+        return null;
+    const gone = Object.keys(was).filter((n) => !(n in is));
+    const born = Object.keys(is).filter((n) => !(n in was));
+    const changed = Object.keys(is).filter((n) => n in was && was[n] !== is[n]);
+    const said = [];
+    if (changed.length > 0)
+        said.push(`${changed.length} ${changedLine(changed)}`);
+    if (born.length > 0)
+        said.push(`${born.length} new: ${list(born)}`);
+    if (gone.length > 0)
+        said.push(`${gone.length} gone: ${list(gone)}`);
+    return said.length > 0 ? said.join(" · ") : null;
 }
+const SHOW = 3;
+const list = (names) => names.length <= SHOW
+    ? names.join(", ")
+    : `${names.slice(0, SHOW).join(", ")} and ${names.length - SHOW} more`;
+const changedLine = (changed) => `component${changed.length === 1 ? "" : "s"} read differently (${list(changed)})`;
 /** Quanto tempo faz, em palavras. Um carimbo ilegível não vira frase. */
 function ago(at) {
     const then = Date.parse(at);

package/package.json

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