synthesisui 0.16.183 → 0.16.185

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) {
@@ -922,11 +929,17 @@ export async function doctor(opts) {
             for (const r of repeats) {
                 const where = `${r.count}\u00d7 in ${r.files} file${r.files === 1 ? "" : "s"}`;
                 const near = r.token ? null : nearestToken(table, r.literal);
-                const named = r.token
-                    ? `  → ${r.token}`
-                    : near
-                        ? `  → nearest is ${near.name} (${near.value})`
-                        : "";
+                /**
+                 * COINCIDÊNCIA NÃO É RESPOSTA - ver `crossFamily` em `scan.ts`. Para aquele `kind` o
+                 * sistema não tem nome; o valor mora noutra família, e dizer só a seta afirma o contrário.
+                 */
+                const named = r.crossFamily
+                    ? `  → no ${r.kind} named for it · the value lives as ${r.token}`
+                    : r.token
+                        ? `  → ${r.token}`
+                        : near
+                            ? `  → nearest is ${near.name} (${near.value})`
+                            : "";
                 say(`      ${r.literal.padEnd(w)}  ${where}${named}`);
             }
         }
@@ -942,11 +955,13 @@ export async function doctor(opts) {
                 // A dead end with a neighbour is not a dead end. Only for lengths -
                 // "nearly the same blue" is the guess this tool must never make.
                 const near = x.token ? null : nearestToken(table, x.literal);
-                const named = x.token
-                    ? `→ ${x.token}`
-                    : near
-                        ? `→ nearest is ${near.name} (${near.value})`
-                        : "→ no token holds this value yet";
+                const named = x.crossFamily
+                    ? `→ no ${x.kind} named for it · the value lives as ${x.token}`
+                    : x.token
+                        ? `→ ${x.token}`
+                        : near
+                            ? `→ nearest is ${near.name} (${near.value})`
+                            : "→ no token holds this value yet";
                 say(`      ${String(x.line).padStart(4)}  ${x.literal}  ${named}`);
             }
             if (f.findings.length > shown.length) {
@@ -1264,8 +1279,19 @@ export async function doctor(opts) {
      * mentir por omissão. Muda a ordem e muda quantos de cada aparecem no teto de cinco.
      */
     const migrating = intent.intent === "migrate";
-    const named = d.repeats.filter((x) => x.token);
-    const unnamed = d.repeats.filter((x) => !x.token);
+    /**
+     * UMA COINCIDÊNCIA NÃO ENTRA NA LISTA DE BARATOS - ver `crossFamily` em `scan.ts`.
+     *
+     * A lista dos "cheap" existe para quem tem dez minutos: trocar o literal pelo token e pronto. Um
+     * match de outra família não é isso - `--fix` o recusa, e o trabalho ali é decidir se aquele
+     * `kind` merece um nome. Medido no repo do dono em 08/08: `2rem` era oferecido como raio porque
+     * existe como degrau de tipo, dez vezes.
+     *
+     * Ele não some: vai para o grupo de quem NÃO tem nome, que é literalmente o que ele é para
+     * aquele kind - e a linha diz onde o valor mora hoje.
+     */
+    const named = d.repeats.filter((x) => x.token && !x.crossFamily);
+    const unnamed = d.repeats.filter((x) => !x.token || x.crossFamily);
     for (const r of named.slice(0, migrating ? 2 : 3)) {
         plan.push({
             rank: migrating ? 4 : 3,
@@ -1280,7 +1306,9 @@ export async function doctor(opts) {
             rank: migrating ? 3 : 4,
             what: near
                 ? `${r.literal} - name it, or snap to ${near.name}`
-                : `${r.literal} - the system has no name for it`,
+                : r.crossFamily
+                    ? `${r.literal} - no ${r.kind} named for it, and the value lives as ${r.token} in another family`
+                    : `${r.literal} - the system has no name for it`,
             size: `${r.files} file${r.files === 1 ? "" : "s"}`,
             cheap: false,
         });

package/dist/doctor/ci-format.js

@@ -82,7 +82,9 @@ export function compareToBaseline(d, base, now) {
 /** O que a mensagem de uma anotação diz, e é a mesma frase nos dois formatos. */
 function messageFor(f) {
     return f.token
-        ? `${f.literal} is written by hand, and this project's system already names it: var(${f.token}). Use the token.`
+        ? f.crossFamily
+            ? `${f.literal} is written by hand, and this project's system has no ${f.kind} named for it. The value does exist elsewhere in the system - as \`${f.token}\`, in another family - so this is a decision to make, not a swap: name a ${f.kind}, or leave it.`
+            : `${f.literal} is written by hand, and this project's system already names it: var(${f.token}). Use the token.`
         : `${f.literal} is a ${f.kind} value written by hand, and the system has no name for it yet. Name it, or file a token request: npx synthesisui request token`;
 }
 /**

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

@@ -489,6 +489,7 @@ export function diagnose(files) {
                 token: f.token,
                 count: 1,
                 files: new Set([f.file]),
+                ...(f.crossFamily ? { crossFamily: true } : {}),
             });
         }
     }
@@ -499,6 +500,7 @@ export function diagnose(files) {
         token: v.token,
         count: v.count,
         files: v.files.size,
+        ...(v.crossFamily ? { crossFamily: true } : {}),
     }))
         .filter((r) => r.count > 1)
         .sort((a, b) => b.count - a.count);

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.183",
+  "version": "0.16.185",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {