synthesisui 0.16.456 → 0.16.458

package/dist/auto-sync.js

@@ -1,4 +1,4 @@
-import { spawn } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 import { readFile, rm, stat, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 /**
@@ -54,11 +54,50 @@ const lockPath = (root) => join(root, "_synthesisui", ".sync-started");
  * `stdio: "ignore"` também é a razão de ele nunca travar: sem terminal, toda pergunta do `sync`
  * (`askToOverwrite`, `askForScope`) responde não sozinha.
  */
+/**
+ * O CENSO SÓ COM A MAIN LIMPA, DEPOIS DE UM COMMIT - jornada "o sistema só muda com commit", E02 (dono,
+ * 27/09: *"o censo só sobe com a pasta limpa, depois de um commit"* e *"só na branch principal (main):
+ * o sistema acompanha o que foi integrado, e commit em branch de trabalho só manda as checagens"*).
+ *
+ * Devolve o commit quando o fim do turno pode mandar o censo: a branch é `main`, `git status` não tem
+ * nada (nem arquivo modificado, nem não versionado), e o commit não é o do último censo. Qualquer
+ * outra coisa - sem git, fora de um repositório, branch de trabalho, pasta suja, git que demora - é
+ * `null`, e o fim do turno manda só as checagens.
+ *
+ * O COMMIT DO ÚLTIMO CENSO MORA NO `.sync-started`: o arquivo já é deste módulo, já está fora do git,
+ * e o conteúdo dele era vazio (só a data servia, como trava). Um arquivo novo mudaria o `.gitignore`
+ * que o `connect` escreve.
+ *
+ * A LACUNA DECLARADA: o commit é anotado quando o envio sai, não quando ele termina. Um envio que
+ * falhar (sem rede, sessão vencida) deixa aquele commit sem censo até o próximo commit na main - ou
+ * até alguém rodar `sync`.
+ */
+const git = (root, args) => new Promise((ok, fail) => {
+    execFile("git", args, { cwd: root, timeout: 3000 }, (err, out) => err ? fail(err) : ok(String(out).trim()));
+});
+const lastCensusHead = async (root) => (await readFile(lockPath(root), "utf8").catch(() => "")).trim();
+export async function censusDue(root) {
+    try {
+        if ((await git(root, ["rev-parse", "--abbrev-ref", "HEAD"])) !== "main")
+            return null;
+        if ((await git(root, ["status", "--porcelain"])) !== "")
+            return null;
+        const head = await git(root, ["rev-parse", "HEAD"]);
+        if (!head || head === (await lastCensusHead(root)))
+            return null;
+        return head;
+    }
+    catch {
+        return null;
+    }
+}
 export async function startSync(root) {
     const last = await stat(lockPath(root)).then((s) => s.mtimeMs, () => 0);
     if (Date.now() - last < SYNC_GAP_MS)
         return false;
-    await writeFile(lockPath(root), "", "utf8");
+    const head = await censusDue(root);
+    /** A trava pela data, e o commit do último censo pelo conteúdo - que só muda quando o censo sai. */
+    await writeFile(lockPath(root), head ?? (await lastCensusHead(root)), "utf8");
     const entry = process.argv[1];
     if (!entry) {
         await rm(lockPath(root), { force: true });
@@ -70,9 +109,11 @@ export async function startSync(root) {
          * sobem só as checagens (...) nada publica de trabalho em andamento"*). O `sync` inteiro remede o
          * repositório e manda o censo, e a rota do censo chama o Autopilot: um turno pela metade, numa
          * branch de trabalho, podia virar versão publicada (medido no CodeLevel, 27/09 00:49).
-         * `--record-only` manda o registro e o estado do repositório, e não remede.
+         * `--record-only` manda o registro e o estado do repositório, e não remede. O `sync` inteiro só
+         * sai quando `censusDue` diz que a main está limpa num commit novo (E02).
          */
-        const child = spawn(process.execPath, [entry, "sync", "--record-only"], {
+        const args = head ? ["sync"] : ["sync", "--record-only"];
+        const child = spawn(process.execPath, [entry, ...args], {
             cwd: root,
             detached: true,
             stdio: "ignore",

package/dist/cn-codegen.js

@@ -58,6 +58,14 @@ export function readVocabulary(themeCss) {
         fontWeights: weights,
     };
 }
+/**
+ * The type scale every Tailwind v4 project has, whether the system declares it or not. Oscilla's
+ * theme.css declares only `--text-display`, so `cn("text-xs", "text-2xl")` kept both and the
+ * stylesheet order decided (refinement round 1, 27/09).
+ */
+const TAILWIND_TEXT_SIZES = [
+    "xs", "sm", "base", "lg", "xl", "2xl", "3xl", "4xl", "5xl", "6xl", "7xl", "8xl", "9xl",
+];
 const set = (names) => `new Set([${names.map((n) => JSON.stringify(n)).join(", ")}])`;
 /** The `cn.ts` a project gets, written against ITS system's vocabulary. */
 export function emitCn(slug, vocab) {
@@ -84,7 +92,7 @@ export function emitCn(slug, vocab) {
 
 /** This system's own namespaces, so \`text-*\` and \`font-*\` are never a guess. */
 const COLORS = ${set(vocab.colors)};
-const TEXT_SIZES = ${set(vocab.textSizes)};
+const TEXT_SIZES = ${set([...new Set([...TAILWIND_TEXT_SIZES, ...vocab.textSizes])])};
 const FONT_FAMILIES = ${set(vocab.fontFamilies)};
 const FONT_WEIGHTS = ${set(vocab.fontWeights)};
 
@@ -97,8 +105,6 @@ const PREFIXES = [
   "rounded-tl", "rounded-tr", "rounded-br", "rounded-bl",
   "rounded-t", "rounded-r", "rounded-b", "rounded-l",
   "rounded",
-  "border-t", "border-r", "border-b", "border-l", "border-x", "border-y",
-  "border",
   "px", "py", "pt", "pr", "pb", "pl", "ps", "pe", "p",
   "mx", "my", "mt", "mr", "mb", "ml", "ms", "me", "m",
   "gap-x", "gap-y", "gap",
@@ -124,6 +130,36 @@ const DISPLAYS = new Set([
 const FLEX_DIRECTIONS = new Set(["row", "col", "row-reverse", "col-reverse"]);
 const FLEX_WRAPS = new Set(["wrap", "nowrap", "wrap-reverse"]);
 
+/**
+ * \`border\` heads THREE properties: the width (\`border\`, \`border-2\`), the style
+ * (\`border-dashed\`) and the colour (\`border-surface\`). Read as one prefix,
+ * \`border border-surface\` kept only the colour and the line vanished - every
+ * card, input and badge in the project, in silence (refinement round 1, 27/09).
+ */
+const BORDER_SIDES = new Set(["t", "r", "b", "l", "x", "y", "s", "e"]);
+const BORDER_STYLES = new Set(["solid", "dashed", "dotted", "double", "hidden", "none"]);
+const COLOR_KEYWORDS = new Set(["transparent", "current", "inherit", "black", "white"]);
+
+function borderGroup(variants: string, rest: string, cls: string): string {
+  const first = rest.split("-")[0];
+  const side = BORDER_SIDES.has(first) ? \`-\${first}\` : "";
+  const tail = side ? rest.slice(first.length + 1) : rest;
+  const isWidth =
+    tail === "" ||
+    [...tail].every((ch) => ch >= "0" && ch <= "9") ||
+    (tail.startsWith("[") && !isArbitraryColor(tail));
+  if (isWidth) return \`\${variants}border\${side}-width\`;
+  if (BORDER_STYLES.has(tail)) return \`\${variants}border-style\`;
+  if (COLORS.has(tail) || COLOR_KEYWORDS.has(tail) || isArbitraryColor(tail)) {
+    return \`\${variants}border\${side}-color\`;
+  }
+  return \`\${variants}\${cls}\`;
+}
+
+function isArbitraryColor(v: string): boolean {
+  return /^\\[(color:|#|rgba?\\(|hsla?\\(|oklch\\(|oklab\\(|var\\(--color)/.test(v);
+}
+
 /**
  * The property this class sets, or the class itself when we cannot tell.
  *
@@ -169,6 +205,7 @@ function groupOf(cls: string): string {
     if (FONT_FAMILIES.has(rest)) return \`\${variants}font-family\`;
     return \`\${variants}\${cls}\`;
   }
+  if (head === "border") return borderGroup(variants, rest, cls);
 
   for (const p of PREFIXES) {
     if (base === p || base.startsWith(\`\${p}-\`)) return \`\${variants}\${p}\`;

package/dist/commands/connect.js

@@ -474,7 +474,7 @@ export async function connect(opts) {
         if (before === null && now !== null)
             await writeAutoSync(root, now);
         row(before === null, now === true
-            ? say("✓ what the check records is sent to your dashboard at the end of each turn")
+            ? say("✓ what the check records is sent to your dashboard at the end of each turn - your system changes only from a commit on a clean main")
             : say("· what the check records stays on this machine - run `npx synthesisui sync` to send it"));
     }
     if (want.hook && wired.hook !== "skipped") {
@@ -875,7 +875,7 @@ async function askToSendAtTurnEnd() {
     const { createInterface } = await import("node:readline/promises");
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     try {
-        const answer = await rl.question(`  ${say("send what the check records to your dashboard at the end of each turn?")} [y/N]: `);
+        const answer = await rl.question(`  ${say("send what the check records to your dashboard at the end of each turn? Your system itself changes only from a commit on a clean main.")} [y/N]: `);
         return /^(y(es)?|s(im)?)$/i.test(answer.trim());
     }
     catch {

package/dist/commands/mcp.js

@@ -409,7 +409,15 @@ async function checkFile(root, path) {
         for (const f of d.findings.slice(0, 40)) {
             out.push(nameToWrite(f)
                 ? `  ${f.file}:${f.line}  ${f.literal} - this repo calls it ${nameToWrite(f)}`
-                : `  ${f.file}:${f.line}  ${f.literal} - no token holds this value`);
+                : /**
+                   * O SISTEMA SEGURA, O PROJETO AINDA NÃO NOMEIA - rodada 1 do refinamento, 27/09. Dizer "no
+                   * token holds this value" sobre o `160ms` que o sistema declara fez o leigo concluir que o
+                   * sistema discordava dele mesmo. O nome continua fora da frase: a grafia `--ds-*` é nossa
+                   * (`INV-GERAL-13`), e batizar o valor no código dele é decisão dele.
+                   */
+                    f.token
+                        ? `  ${f.file}:${f.line}  ${f.literal} - the system holds this value, and your code has no name for it yet`
+                        : `  ${f.file}:${f.line}  ${f.literal} - no token holds this value`);
         }
         out.push("", "Replace the ones that have a token. For a value with none, do NOT invent a token: say which value it is and what you would call it, and let a person decide.");
     }

package/dist/copy/connect.pt-BR.js

@@ -34,9 +34,9 @@ register("pt-BR", {
     // ── a fiação do agente ──
     "✓ .claude/settings.json  the check now runs at the end of each agent turn": "✓ .claude/settings.json  a verificação roda no fim de cada turno do agente",
     "✓ .claude/settings.json  the check moved from every write to the end of each agent turn": "✓ .claude/settings.json  a verificação saiu de cada escrita e foi para o fim de cada turno do agente",
-    "✓ what the check records is sent to your dashboard at the end of each turn": "✓ o que a verificação registra vai para o seu painel no fim de cada turno",
+    "✓ what the check records is sent to your dashboard at the end of each turn - your system changes only from a commit on a clean main": "✓ o que a verificação registra vai para o seu painel no fim de cada turno - o seu sistema só muda com um commit na main limpa",
     "· what the check records stays on this machine - run `npx synthesisui sync` to send it": "· o que a verificação registra fica nesta máquina - rode `npx synthesisui sync` para enviar",
-    "send what the check records to your dashboard at the end of each turn?": "enviar o que a verificação registra para o seu painel no fim de cada turno?",
+    "send what the check records to your dashboard at the end of each turn? Your system itself changes only from a commit on a clean main.": "enviar o que a verificação registra para o seu painel no fim de cada turno? O seu sistema em si só muda com um commit na main limpa.",
     "· Codex has no end-of-turn hook we can hold - run `npx synthesisui doctor` to check what it wrote": "· o Codex não tem um fim de turno que a gente possa segurar - rode `npx synthesisui doctor` para checar o que ele escreveu",
     "· .claude/settings.json  already had it": "· .claude/settings.json  já estava lá",
     "✓ .claude/settings.json  each session opens with what is missing": "✓ .claude/settings.json  cada sessão abre com o que falta",

package/dist/doctor/scan.js

@@ -515,6 +515,15 @@ function scanCore(file, source, table) {
         };
     }
     let svgDepth = 0;
+    /**
+     * DENTRO DE `@theme` OU `:root`, UMA DECLARAÇÃO É O VOCABULÁRIO, NÃO UM USO - rodada 1 do refinamento,
+     * 27/09. O leigo copiou os valores do sistema para o `@theme` do projeto novo, como o GUIDE ensina, e o
+     * `check_file` respondeu "17% (...) 19 written by hand", linha por linha, com o conserto circular
+     * "#0a100d - this repo calls it --color-canvas" na própria linha `--color-canvas: #0a100d;`.
+     * Profundidade de chaves, e não uma flag, porque `@theme` pode abrir bloco dentro de bloco.
+     */
+    let tokenBlockDepth = 0;
+    let braceDepth = 0;
     source.split("\n").forEach((raw, i) => {
         const line = raw.trim();
         /**
@@ -528,6 +537,14 @@ function scanCore(file, source, table) {
          */
         const indent = line ? raw.indexOf(line) : 0;
         const at = i + 1;
+        const depthBefore = braceDepth;
+        const opensTokenBlock = /^(@theme\b|:root\b)/.test(line) && line.includes("{");
+        if (opensTokenBlock && tokenBlockDepth === 0)
+            tokenBlockDepth = depthBefore + 1;
+        const inTokenBlock = tokenBlockDepth > 0 && (opensTokenBlock || depthBefore >= tokenBlockDepth);
+        braceDepth = Math.max(0, braceDepth + (line.match(/\{/g) ?? []).length - (line.match(/\}/g) ?? []).length);
+        if (tokenBlockDepth > 0 && braceDepth < tokenBlockDepth)
+            tokenBlockDepth = 0;
         tokenUses += countTokenUses(line, table);
         /**
          * O QUE ESTE ARQUIVO DECLARA E O QUE ELE USA DE FORA DO SISTEMA - ver `FileReport.ownDeclared`.
@@ -577,6 +594,8 @@ function scanCore(file, source, table) {
         const declares = DECLARES_TOKEN.exec(line);
         if (declares && table.byName.has(declares[1].toLowerCase()))
             return;
+        if (declares && inTokenBlock)
+            return;
         // `rgba(${r}, ${g}, ${b}, ${a})` is code computing a colour, not a colour
         // written by hand - flagging it would be telling someone to tokenize a
         // variable. And the same literal twice in one declaration (a two-stop

package/dist/install-marks.js

@@ -397,7 +397,18 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * turno, e o censo chama o Autopilot: trabalho pela metade pode virar versão. Quem está atrás precisa
  * saber.
  */
-export const CHECKER_SINCE = "0.16.456";
+/**
+ * 0.16.456 -> 0.16.457 em 27/09, e o passo 1 dá **SIM**: a 0.16.456 foi publicada antes da E02 da
+ * mesma jornada, e o hook fixado nela manda só o registro em todo turno - nunca o censo, nem com a
+ * main limpa num commit novo. Quem está nela não vê o sistema mudar depois do commit, e precisa saber.
+ */
+/**
+ * 0.16.457 -> 0.16.458 em 27/09, e o passo 1 dá **SIM**: a varredura que o hook roda deixa de acusar as
+ * declarações dentro de `@theme` e `:root` (rodada 1 do refinamento - o `check_file` dava "19 written by
+ * hand" no `@theme` que o leigo copiou do GUIDE). Um hook fixado antes continua acusando o vocabulário do
+ * projeto como valor à mão, em todo turno.
+ */
+export const CHECKER_SINCE = "0.16.458";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *

package/package.json

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