synthesisui 0.16.477 → 0.16.478

package/dist/commands/hook.js

@@ -1,4 +1,5 @@
 import { readFile, stat, writeFile } from "node:fs/promises";
+import { ourSpellingLines } from "../our-spelling.js";
 import { join, relative, resolve } from "node:path";
 import { readAutoSync, startSync } from "../auto-sync.js";
 import { changedSince } from "../changed-files.js";
@@ -309,6 +310,8 @@ async function report(root, filePath, mode) {
     const phantoms = d.files.flatMap((f) => f.phantoms ?? []);
     /** Fora da escala - ver `OffScale` (bateria, 28/09). Entra nas mesmas portas que os `phantoms`. */
     const offScale = describeOffScale(d.files);
+    /** A nossa grafia no arquivo dele - ver `our-spelling.ts`. Entra nas mesmas portas que os `phantoms`. */
+    const ours = d.tokenUses;
     // Every check leaves one line in the ledger - INCLUDING the clean ones,
     // because a fix is itself a write, so the clean re-check of a file that was
     // just flagged is the evidence the agent read the report and acted. Without
@@ -329,7 +332,8 @@ async function report(root, filePath, mode) {
         named.length === 0 &&
         phantoms.length === 0 &&
         offScale.length === 0 &&
-        unnamed.length === 0) {
+        unnamed.length === 0 &&
+        ours === 0) {
         const hello = await greet(root, rel);
         return hello ? say(hello) : null;
     }
@@ -366,7 +370,8 @@ async function report(root, filePath, mode) {
         broke.length > 0 &&
         named.length === 0 &&
         phantoms.length === 0 &&
-        offScale.length === 0)
+        offScale.length === 0 &&
+        ours === 0)
         return say(broke.join("\n"));
     const sample = unnamed
         .slice(0, 3)
@@ -376,7 +381,8 @@ async function report(root, filePath, mode) {
         broke.length === 0 &&
         named.length === 0 &&
         phantoms.length === 0 &&
-        offScale.length === 0)
+        offScale.length === 0 &&
+        ours === 0)
         return say([
             `${rel} - ${unnamed.length} value${unnamed.length === 1 ? "" : "s"} here ${unnamed.length === 1 ? "has" : "have"} no name in this system, and nothing to replace ${unnamed.length === 1 ? "it" : "them"} with: ${sample}${unnamed.length > 3 ? `, +${unnamed.length - 3} more` : ""}.`,
             "Do not invent a name - leave them, or ask the person what they would call it.",
@@ -425,6 +431,8 @@ async function report(root, filePath, mode) {
         lines.push("", "Names this system does not declare. These look tokenized and apply nothing at all:", ...phantoms.slice(0, 20).map((p) => `  line ${p.line}  ${p.name}`), "", "Use a name the system has, or say which value you need and what you would call it. Do NOT invent a token.");
     }
     lines.push(...offScale);
+    if (ours > 0)
+        lines.push("", ...ourSpellingLines(ours));
     return say(lines.join("\n"));
 }
 /**

package/dist/commands/mcp.js

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+import { ourSpellingLines } from "../our-spelling.js";
 import { readdir, readFile } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
 import { provenanceAction, toolSlug, withSource, } from "../agent-provenance.js";
@@ -411,6 +412,8 @@ async function checkFile(root, path) {
         ? [
             `${table.name ?? table.slug}: ${d.reach.percent}% of design values come from the system - ${d.reach.uses} of ${d.reach.of}.`,
             `${d.tokenUses} from the system, ${d.findings.length} written by hand${d.phantomUses > 0 ? `, ${d.phantomUses} naming nothing` : ""}.`,
+            /** A nossa grafia, dita - ver `our-spelling.ts`. */
+            ...(d.tokenUses > 0 ? ourSpellingLines(d.tokenUses) : []),
         ]
         : [
             `${table.name ?? table.slug}: ${d.reach.why} here, so there is no coverage to report - not 0%, and not 100%.`,

package/dist/install-marks.js

@@ -501,7 +501,11 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * que sai da escala - o ponto de quebra fora das larguras do sistema, a conta em cima de um token, e o `1px` de borda
  * num projeto que tem nome para ele. Um hook anterior aprova os três.
  */
-export const CHECKER_SINCE = "0.16.475";
+/**
+ * 0.16.475 -> 0.16.478 em 28/09, e o passo 1 dá **SIM** (etapa 02, "a nossa grafia conta como nossa"): o fim do turno diz
+ * quando o arquivo usa `var(--ds-*)` - o valor do sistema com o NOSSO nome. Um hook anterior cala sobre esse arquivo.
+ */
+export const CHECKER_SINCE = "0.16.478";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *

package/dist/our-spelling.js

@@ -0,0 +1,17 @@
+/**
+ * A NOSSA GRAFIA NO CÓDIGO DELE, DITA NUM LUGAR SÓ - etapa 02 da jornada "o projeto sem cor escolhe as suas", 28/09.
+ *
+ * `var(--ds-*)` é o valor do sistema com o NOSSO nome. No b6 da bateria o agente copiou 40 variáveis nossas para o
+ * `globals.css` do projeto, e as três vozes que medem um arquivo - o `sync`, o `check_file` e o fim do turno -
+ * contavam aquilo como vitória. A linha dele (28/09): o vocabulário no código é sempre o do cliente.
+ *
+ * A frase mora aqui porque são três leitores: com três cópias, a primeira edição faz duas discordarem.
+ */
+export const OUR_SPELLING = "in our spelling (var(--ds-*)) - not a name your project declares";
+/** As duas linhas do `check_file` e do fim do turno: o fato, com o número, e o que o agente faz com ele. */
+export function ourSpellingLines(uses) {
+    return [
+        `${uses} value${uses === 1 ? "" : "s"} here come${uses === 1 ? "s" : ""} from the system ${OUR_SPELLING}.`,
+        "Tell the person in one line. Do not rename them on your own - which names the project uses is the person's decision.",
+    ];
+}

package/dist/what-grew.js

@@ -1,6 +1,7 @@
 import { readFile } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
 import { readStyleSheet } from "./doctor/scss-lens.js";
+import { OUR_SPELLING } from "./our-spelling.js";
 import { loadSystem, walkAll } from "./commands/doctor.js";
 import { diagnose, scanSource } from "./doctor/scan.js";
 export async function whatGrew(root, census, 
@@ -74,12 +75,24 @@ before) {
             fromSystem: d.reach.measured ? d.reach.uses : 0,
             of: d.reach.measured ? d.reach.of : 0,
             byHand: [...new Set(d.findings.map((f) => f.literal))],
+            ...(d.reach.measured && d.tokenUses > 0 ? { ours: d.tokenUses } : {}),
             ...(utilities ? { utilities: true } : {}),
             ...(composed(src, c.name) >= 3 ? { composes: composed(src, c.name) } : {}),
         });
     }
     return { born, gone };
 }
+/**
+ * A NOSSA GRAFIA, DITA - o valor é do sistema, o nome é o nosso, e o vocabulário no código é sempre o dele (28/09).
+ * Contar `var(--ds-*)` como vitória premiava o agente que copia os nossos nomes para o projeto.
+ */
+function ourSpelling(b) {
+    if (!b.ours)
+        return "";
+    return b.ours >= b.fromSystem
+        ? `, all ${b.ours} ${OUR_SPELLING}`
+        : `, ${b.ours} of them ${OUR_SPELLING}`;
+}
 /** As linhas do bloco, ou nada. Uma por componente: o nome, o arquivo, a medida e o que ficou à mão. */
 export function describeGrowth(grown) {
     const out = [];
@@ -88,7 +101,7 @@ export function describeGrowth(grown) {
             ? b.utilities
                 ? `${b.name} (${b.file}) - styled with utility classes; \`npx synthesisui doctor\` measures those`
                 : `${b.name} (${b.file}) - no colour or spacing of its own to measure`
-            : `${b.name} (${b.file}) - ${b.fromSystem} of ${b.of} values from your system${b.byHand.length > 0 ? `; by hand: ${b.byHand.slice(0, 4).join(", ")}${b.byHand.length > 4 ? ", …" : ""}` : ""}`);
+            : `${b.name} (${b.file}) - ${b.fromSystem} of ${b.of} values from your system${ourSpelling(b)}${b.byHand.length > 0 ? `; by hand: ${b.byHand.slice(0, 4).join(", ")}${b.byHand.length > 4 ? ", …" : ""}` : ""}`);
     /** A tela que mora na pasta de componentes: a linha pergunta, e quem responde decide. */
     for (const [i, b] of grown.born.entries())
         if (b.composes)

package/package.json

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