synthesisui 0.16.184 → 0.16.186

package/dist/commands/doctor.js

@@ -8,7 +8,7 @@ import { emptyTally, internalSpecifiers, scanComponentsInto, tallyToInventory, }
 import { checkContracts } from "../doctor/contract-check.js";
 import { describeMissing, missingDependencies, summarizeMissing, } from "../doctor/dependencies.js";
 import { findFrozenBindings } from "../doctor/frozen.js";
-import { appendEvent, readEvents, summarize } from "../doctor/ledger.js";
+import { appendEvent, readEvents, suggestionsFrom, summarize, } from "../doctor/ledger.js";
 import { bindingsFromDocument, countComponents, findOverrides, } from "../doctor/overrides.js";
 import { checkableName, readRequests, verifyAndCloseRequests, } from "../doctor/requests.js";
 import { diagnose, scanSource, siblingTokens, } from "../doctor/scan.js";
@@ -706,6 +706,9 @@ export async function doctor(opts) {
                 ...(d.findings.some((f) => f.crossFamily)
                     ? { crossFamily: d.findings.filter((f) => f.crossFamily).length }
                     : {}),
+                ...(d.repeats.some((r) => r.token)
+                    ? { matched: suggestionsFrom(d.repeats) }
+                    : {}),
             }).catch(() => { });
         console.log("");
         if (opts.fix) {
@@ -796,6 +799,10 @@ export async function doctor(opts) {
             coverage: d.coverage,
             named: d.named,
             ...(crossFamily > 0 ? { crossFamily } : {}),
+            /** E os pares em si, para a plataforma reavaliar sem esperar outra medição - ver `matched`. */
+            ...(d.repeats.some((r) => r.token)
+                ? { matched: suggestionsFrom(d.repeats) }
+                : {}),
         });
     }
     if (hasSystem && fullRun) {

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/doctor/ledger.js

@@ -27,6 +27,32 @@ import { join } from "node:path";
  * same contract every log file that survives a decade has.
  */
 export const LEDGER_FILE = "ledger.jsonl";
+/**
+ * TETO, porque isto viaja e cai num campo `jsonb`.
+ *
+ * 72 no repo do dono, e a lista já vem ordenada por frequência - então o corte pega a cauda, que é
+ * onde mora o valor escrito uma vez em um arquivo. Um repo que passe disso perde a cauda e mantém
+ * inteiro o que decide alguma coisa.
+ */
+const MATCHED_CAP = 300;
+/**
+ * Os pares a mandar, do agregado que o doctor já monta.
+ *
+ * Só o que casou com um token: uma sugestão que não existe não tem família para comparar, e as 714
+ * sem token do repo do dono são 90% do volume e 0% da informação. A forma é estrutural de propósito -
+ * `Diagnosis` mora em `scan.ts`, e importar de lá para cá fecharia um ciclo.
+ */
+export function suggestionsFrom(repeats) {
+    return repeats
+        .filter((r) => Boolean(r.token))
+        .slice(0, MATCHED_CAP)
+        .map((r) => ({
+        literal: r.literal,
+        kind: r.kind,
+        token: r.token,
+        count: r.count,
+    }));
+}
 const ledgerPath = (root) => join(root, "_synthesisui", LEDGER_FILE);
 /** Keep the file from growing forever: past ~1MB, keep the newest half. A
  *  trend needs recent history, not an archive. */

package/dist/repo-state.js

@@ -53,6 +53,9 @@ export async function repoStateOf(projectRoot, slug, cli) {
         ...(typeof doctor?.crossFamily === "number"
             ? { crossFamily: doctor.crossFamily }
             : {}),
+        ...(doctor?.matched && doctor.matched.length > 0
+            ? { matched: doctor.matched }
+            : {}),
         ...(typeof lock?.fetchedAt === "string"
             ? { installedAt: lock.fetchedAt }
             : {}),

package/package.json

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