synthesisui 0.16.233 → 0.16.234

package/dist/commands/use.js

@@ -53,9 +53,9 @@ export async function use(slug, intent, opts) {
     const hasDoctrine = await exists(join(slugDir, "doctrine.json"));
     const readFirst = [
         hasDoctrine
-            ? "- Call `system_doctrine` first — this system's rules and philosophy, pinned to the installed version; obey them above everything else. Without MCP, the same data is `doctrine.json` and the `philosophy` of `design-system.json`"
+            ? "- Call `system_doctrine` first - this system's rules and philosophy, pinned to the installed version; obey them above everything else. Without MCP, the same data is `doctrine.json` and the `philosophy` of `design-system.json`"
             : "",
-        `- ${base}/v${version}/GUIDE.md — how to apply the system, the recipes and the token vocabulary`,
+        `- ${base}/v${version}/GUIDE.md - how to apply the system, the recipes and the token vocabulary`,
     ].filter(Boolean);
     // The styling contract differs by target: Next projects in this product use
     // Tailwind v4 backed by the DS; the "general" target is framework-agnostic CSS.

package/dist/doctor/ledger.js

@@ -1,5 +1,6 @@
 import { appendFile, readFile, stat, writeFile } from "node:fs/promises";
 import { join } from "node:path";
+import { nameToWrite } from "./scan.js";
 /**
  * THE LAYER THAT REMEMBERS - governance that cannot answer "is it getting
  * better?" is a sequence of moments, not a system.
@@ -43,13 +44,23 @@ const MATCHED_CAP = 300;
  * `Diagnosis` mora em `scan.ts`, e importar de lá para cá fecharia um ciclo.
  */
 export function suggestionsFrom(repeats) {
+    /**
+     * O FILTRO É "TEM NOME", e não "tem nome NOSSO" - senão a contagem do outro lado mente.
+     *
+     * A versão anterior exigia `r.token`, então as 23 sugestões que só o vocabulário DELE nomeia nunca
+     * saíam do repositório: a plataforma achava que 59 ofertas foram feitas onde foram 82. Para COR não
+     * há julgamento a perder (um hex numa posição de cor não tem ambiguidade de família), mas "0 de 843
+     * erradas" é um fato, e não ter o número é diferente de o número ser zero.
+     */
     return repeats
-        .filter((r) => Boolean(r.token))
+        .filter((r) => Boolean(nameToWrite(r)))
         .slice(0, MATCHED_CAP)
         .map((r) => ({
         literal: r.literal,
         kind: r.kind,
         token: r.token,
+        /** Não-nulo por construção: o filtro acima só deixa passar quem tem nome. */
+        shown: nameToWrite(r),
         count: r.count,
     }));
 }

package/dist/doctor/their-names.js

@@ -1,4 +1,4 @@
-import { DS_FAMILY, familySays, normalizeValue, } from "./tokens.js";
+import { FAMILY_PREFIX, familySays, normalizeValue, } from "./tokens.js";
 /**
  * COMO ELE CHAMA O VALOR - para a gente parar de renomear as variáveis dele.
  *
@@ -116,7 +116,7 @@ export function theirNames(ours, theirs) {
         const head = segments(name)[0] ?? "";
         convention.set(head, (convention.get(head) ?? 0) + 1);
     }
-    for (const [kind, prefix] of Object.entries(DS_FAMILY)) {
+    for (const [kind, prefix] of Object.entries(FAMILY_PREFIX)) {
         for (const [name, raw] of ours.byName) {
             if (!name.startsWith(prefix))
                 continue;

package/dist/doctor/tokens.js

@@ -506,7 +506,15 @@ export function nearestToken(table, literal) {
  */
 /** Exportado para `their-names.ts`, que precisa da MESMA divisão de família para validar a natureza
  *  de um nome dele - duas tabelas de família seriam duas leis. */
-export const DS_FAMILY = {
+/**
+ * O ESPELHO de `FAMILY_PREFIX` e `FAMILY_WORDS` em `libs/ds-contracts/src/token-ref.ts`.
+ *
+ * O CLI é publicado standalone (`dependencies: {}`) e não pode importar os contratos, então as duas
+ * cópias são inevitáveis - `family-vocabulary.spec.ts` compara as duas com o arquivo do contrato, como
+ * o gêmeo do `frontier-kind` já faz. O nome é o MESMO dos dois lados de propósito: `DS_FAMILY` aqui e
+ * `FAMILY` lá era a mesma tabela com dois nomes, e ninguém que lesse um dos dois saberia do outro.
+ */
+export const FAMILY_PREFIX = {
     color: "--ds-color-",
     radius: "--ds-radius-",
     spacing: "--ds-spacing-",
@@ -576,7 +584,7 @@ export function tokenMatch(table, literal, kind) {
     const hit = table.byValue.get(normalizeValue(literal, table.rootPx));
     if (!hit || hit.length === 0)
         return null;
-    const prefix = kind ? DS_FAMILY[kind] : undefined;
+    const prefix = kind ? FAMILY_PREFIX[kind] : undefined;
     const family = prefix ? hit.filter((n) => n.startsWith(prefix)) : [];
     const pool = family.length > 0 ? family : hit;
     // Semantic roles name intent; primitives name a shelf. Prefer intent.

package/dist/last-sync.js

@@ -124,7 +124,7 @@ export function describeDelta(now, before) {
         ? `, 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}`;
+        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 é

package/package.json

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